Conventions du premier projet
Statut documentaire : guide.
Le premier exemple doit enseigner les règles que les projets de production sont censés conserver.
Posséder le namespace
Les concepts d'application utilisent un préfixe appartenant au projet. Un tutoriel de tâches utilise donc une identité comme tsk#task ; il n'emprunte pas un namespace plateforme pour un concept applicatif.
Garder les exemples neutres vis-à-vis de l'implémentation
Utiliser exactement les noms de classes publiés dans l’ABI, par exemple CustomClassItem, GUIDStringGeneratorInfo et CustomObjectItem. Ne pas exposer les noms des classes internes. La disponibilité d'une classe doit être vérifiée dans le manifeste de la version cible.
Utiliser des chemins portables dans la documentation
Ne publiez pas de chemins absolus propres à un poste de travail, notamment des lecteurs de test. Préférez des placeholders et des chemins projet avec slash, sauf section spécifique à une plateforme certifiée.
Valider avant d'étendre
Prouvez d'abord le chargement du package et la visibilité du modèle. Ajoutez ensuite collections, actions, validation, DataSets, services et composants réactifs.