Ah et la seule chose qui m'a retenu l'attention dans les exemples de l'article, c'est l'inclusion s'un bout de code via une directive include. De prime abord tu te dis "cool" plus besoin de faire des copier/coller...puis tu réfléchis un peu et tu te dis que si tu fais ça ton markdown ne peut plus bouger ou tu vas péter le lien, tu pourrais avoir des incohérences entre ce que dit la doc et l'exemple dans le code block parce que tu as modifié le code, etc, etc. Et cela sans que tu ne t'en rendes compte si tu ne vas pas vérifier. Et au final ce sont ces vérifications et changements qui te coûtent plus qu'un pauvre petit copier/coller dans le cycle de vie de ta documentation.
[^] # Re: adoption
Posté par Psychofox (Mastodon) . En réponse au lien Les limites de Markdown (pour rédiger de la documentation) face aux capacités d’Asciidoc. Évalué à 4.
Ah et la seule chose qui m'a retenu l'attention dans les exemples de l'article, c'est l'inclusion s'un bout de code via une directive include. De prime abord tu te dis "cool" plus besoin de faire des copier/coller...puis tu réfléchis un peu et tu te dis que si tu fais ça ton markdown ne peut plus bouger ou tu vas péter le lien, tu pourrais avoir des incohérences entre ce que dit la doc et l'exemple dans le code block parce que tu as modifié le code, etc, etc. Et cela sans que tu ne t'en rendes compte si tu ne vas pas vérifier. Et au final ce sont ces vérifications et changements qui te coûtent plus qu'un pauvre petit copier/coller dans le cycle de vie de ta documentation.
Du coup y gagnes t'on vraiment?