4 ms·
I never saw the point in Diataxis, but honestly while vibe coding it's pretty convenient to tell an LLM "do diataxis" and get decent first pass documentation ou
by conradludgate 2mo ago
I never saw the point in Diataxis, but honestly while vibe coding it's pretty convenient to tell an LLM "do diataxis" and get decent first pass documentation out of it.
- c0rruptbytes 2mo agosame, it’s great for first pass LLM docs
- radicalriddler 2mo agoAgreed, a couple months back, I got cf to crawl the site and created a block of skills around it for personal use.
- nchmy 2mo agoIve been aware of diataxis for a while, but i hadnt considered such an approach. Will definitely keep it in mind for when im ready to generate some sort of docs. Thanks!
- WillAdams 2mo agoI found it helpful in thinking about code and the approach for my current project: https://github.com/WillAdams/gcodepreview https://github.com/WillAdams/gcodepreview In particular, it made it seem obvious to split up the documentation between: - Overview --- readme.md - Tutorials --- handled in various template files - How to Guides --- embedded in the Literate Program code - Reference --- the indices and Command Glossary
- amazingman 2mo agoYou clearly do see the point!
- conradludgate 2mo agoI used past tense for a reason ;)
- amazingman 2mo agoAh, fair! English can be so precise and yet still ... not quite :)
- i_v 2mo agoWith tutorials, I’ve been enjoying handing my agent a directory of screenshots, talking out the process, then having it organize it all into a guide. Huge fan of Diataxis over the years!
- keeganpoppen 2mo agoyeah, the urge to turn this page into a skill and then just let it run loose on all my random vibe-coded side projects is very, very strong. seems great for that kind of thing.