Livrer la documentation avec le code source

Livrer la documentation sous forme texte à côté du code est vraiment très pratique pour vos utilisateurs, merci d'y penser 😊

Je m'explique: pour un ancien projet, je dois utiliser une vielle version de composer, un outil de gestion de dépendances pour les projets PHP.

Comme j'ai eu besoin de toucher aux dépendances du projet, je devais retrouver les bonnes options de composer v1.

Seulement, la documentation en ligne de composer donne les informations pour la dernière version publiée (v2.x).

Heureusement le code source de composer contient aussi la documentation. Il m'a donc suffit de télécharger la release de la version nécessaire et de parcourir le dossier docs de composer pour retrouver les bonnes options disponibles.

Ce dossier contient des fichiers textes, je n'ai donc même pas eu besoin de démarrer un serveur web pour visualiser la documentation.

Commentaires

Répondez à ce message du Fediverse pour ajouter un commentaire sur cet article.