idée de format de kata : "Skill issue"
Basée sur l'idée de "mauvaise foi dans le code, bonne foi dans les tests". (poke @romeu )
Driver joue le rôle d'un agent IA de mauvaise foi.
Driver dispose de quelques fichiers skill.md initialement un peu ambigües.
Driver les interprète de la pire façon.
Ensemble du groupe doit changer ses instructions et/ou les skills pour que Driver fait ce qui est attendu.
Le kata se fait sans L'utilisation de vrai LLM (indeed completion AI)
Accessibilité des ressources pédagogiques.
Ils organisent les premières "Forgéales" : des soirées de partage en visio les 24, 25 et 26 juin.
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)