Je découvre une initiative qui s'appelle "La forge des communs numériques éducatifs".
La Forge des communs numériques éducatifs ?
- C’est une communauté d’enseignantes et d’enseignants qui créent et partagent des logiciels et des ressources éducatives libres.
- Ces outils sont conçus pour être utiles à leurs collègues et à leurs élèves, dans leur pratique quotidienne.
- Tout cela se passe dans un espace de travail collaboratif en ligne, qui rassemble plusieurs milliers de projets.
- Chacun peut utiliser ces ressources, les adapter à ses besoins, et surtout, y contribuer librement.
- Un lieu ouvert, vivant, fait par et pour la communauté éducative !
Ils organisent les premières "Forgéales" : des soirées de partage en visio les 24, 25 et 26 juin.
Diátaxis
A systematic approach to technical documentation authoring.
Diátaxis is a way of thinking about and doing documentation.
It prescribes approaches to content, architecture and form that emerge from a systematic approach to understanding the needs of documentation users.
Diátaxis identifies four distinct needs, and four corresponding forms of documentation - tutorials, how-to guides, technical reference and explanation. It places them in a systematic relationship, and proposes that documentation should itself be organised around the structures of those needs.
Diátaxis solves problems related to documentation content (what to write), style (how to write it) and architecture (how to organise it).
As well as serving the users of documentation, Diátaxis has value for documentation creators and maintainers. It is light-weight, easy to grasp and straightforward to apply. It doesn’t impose implementation constraints. It brings an active principle of quality to documentation that helps maintainers think effectively about their own work.
tutorialsandhow-to guidesare concerned with what the user does (action)referenceandexplanationare about what the user knows (cognition)
On the other hand:
tutorialsandexplanationserve the acquistion of skill (the user’s study)how-to guidesandreferenceserve the application of skill (the user’s work)