Aller au contenu
EN FR

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.