Où met on la doc dans un développement

Si je reprends mes vieilles méthodes d’anciens développeurs, je mettais beaucoup de commentaires . mais il y a longtemps.

Mais avec ces outils modernes, y a t il un moyen pour intégrer les commentaires ?

Bonjour.
Je ne suis pas sure de la question;
mais voici une réponses.

// Creation de procedure pour taxe Canada

var tps = 7.5 // taux actuel oct 2017
var tvq = 9.75 // Taux actuel oct 2017

//
// **********
// * Calcul *
// ***********

let total = total * tps
.
.
. :smiley:

Donc tu peut commenter les procedure, // après les instruction de code
ou même des info comme je fait souvent au début de mes programme

/*
Date: creation = 18 Octobre 2017
Nom du programme: testMemo
version swift:,.,.,.4
version xcode:.,. 9
version IOS.,.,.,.,11
Programmeur:
*/

Donc pour ouvrir plusieure ligne de commentaire
/* et pour terminer l’inverse */
:roll_eyes:

Si tu parles de générer automatiquement une documentation à partir des commentaires alors oui c’est possible.
En respectant un certain format de commentaires avant chaque classe et fonction, XCode peut ensuite les reconnaître et les afficher automatiquement :

Si tu veux aller plus loin et générer une doc complète en HTML à partir de ces commentaires il existe plusieurs outils comme par exemple Jazzy

2 « J'aime »