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

Si un exemple historique de métadonnées nomme un binding d'implémentation avec un préfixe T, la documentation publique conserve l'exemple mais normalise l'identifiant public de TXXX vers XXX. Par exemple, CustomClassItem, GUIDStringGeneratorInfo et CustomObjectItem sont les formes de documentation publique.

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.