La documentation. Quelle documentation ? Ou plutôt quelleS documentationS ? https://videos.capitoledulibre.org/videos/watch/76558e5f-8e39-453f-9c49-cc0ad10aa286 Raphael "Relf" Isla Un projet est-il vraiment libre s'il n'est pas documenté ? Un code est-il ouvert s'il n'est pas expliqué ? Non. Et pourtant, la documentation d'un projet est souvent mise en place seulement après coup et maintenue de la même manière, comme un parent pauvre (parmi d'autres, comme l'ux et l'accessibilité). Alors qu'elle est indispensable, en particulier si le facteur bus du projet est de 1. Alors comment s'assurer d'avoir une bonne documentation ? Quelles questions se poser pour aborder sereinement cette partie du projet ? Slides : https://cfp.capitoledulibre.org/media/cdl-2024/submissions/XVPQEP/resources/Support_de_conf_-Cdl-_Documentation_joeMZir.odp Captation par @TVn7Toulouse Sat, 11 Apr 2026 11:30:24 GMT https://validator.w3.org/feed/docs/rss2.html PeerTube - https://videos.capitoledulibre.org La documentation. Quelle documentation ? Ou plutôt quelleS documentationS ? https://videos.capitoledulibre.org/lazy-static/avatars/61548430-e201-4f4b-ac5a-f903422c6ea2.png https://videos.capitoledulibre.org/videos/watch/76558e5f-8e39-453f-9c49-cc0ad10aa286 All rights reserved, unless otherwise specified in the terms specified at https://videos.capitoledulibre.org/about and potential licenses granted by each content's rightholder. <![CDATA[La documentation. Quelle documentation ? Ou plutôt quelleS documentationS ? - Sébastien Dinot]]> https://videos.capitoledulibre.org/w/fBw9VtmEtxVZC1EHoTKhbs;threadId=13 https://videos.capitoledulibre.org/w/fBw9VtmEtxVZC1EHoTKhbs;threadId=13 Wed, 08 Jan 2025 21:56:00 GMT @Relf, merci pour la conférence. Une ressource que je pointe souvent aux développeurs, que l'on somme d'écrire de la documentation sans jamais leur expliquer comment l'écrire, est The Documentation System :

https://docs.divio.com/documentation-system/

]]> Sébastien Dinot