Repository with sources and generator of https://larlet.fr/david/ https://larlet.fr/david/
Du kannst nicht mehr als 25 Themen auswählen Themen müssen mit entweder einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.

2021-09-09 - Documentation.md 1.1KB

vor 3 Jahren
123456789101112131415161718
  1. # Documentation
  2. > [en] Here are six requirements that I have on a project for it to reach my gold approval for stellar docs.
  3. >
  4. > 1. Your docs belong in the code repository
  5. > 2. Your docs is not extracted from code
  6. > 3. Your docs features examples
  7. > 4. You document every API call you provide
  8. > 5. Your docs is easily accessible and browsed
  9. > 6. Your docs should be ==easy to contribute to==
  10. >
  11. > <cite>*[Making world-class docs takes effort](https://daniel.haxx.se/blog/2021/09/04/making-world-class-docs-takes-effort/)* ([cache](/david/cache/2021/f327a02cabbad6884b057958ec213668/))</cite>
  12. J’ai mis en place un document collaboratif [dernièrement](/david/2021/09/01/) en prenant pour acquis que le markdown était lisible et éditable. *C’était une grossière erreur.* Même avec l’aide de hackmd, un document contenant principalement des liens est interprété comme étant trop technique pour être accessible à des personnes n’ayant pas cette habitude.
  13. Un bon rappel que la route est [encore très longue…](https://degooglisons-internet.org/fr/) ([cache](/david/cache/2021/8589fdcb9656efb132e1513c07d48bd1/))
  14. #partage #technique #accompagnement