Diátaxis

4 comments

• Hnrobert42 51 minutes ago
  I urge people to not read this. Once you do, you will see all documentation will as the flawed and confusing mess it is. Ignorance is bliss!
  [-]
  • swyx 33 minutes ago
    truly. its the kind of thing that makes docs people justify their jobs rather than coming from a founder or user centric pov
• conradludgate 54 minutes 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.
  [-]
  • radicalriddler 22 minutes ago
    Agreed, a couple months back, I got cf to crawl the site and created a block of skills around it for personal use.
  • c0rruptbytes 46 minutes ago
    same, it’s great for first pass LLM docs
• smokel 46 minutes ago
  Perhaps add "A systematic approach to technical documentation authoring" to the title?
• tedd4u 59 minutes ago
  Posted many times. Here's the most recent time from 2024 (also has most discussion).

  https://news.ycombinator.com/item?id=42325011