Diátaxis

4 comments

• Hnrobert42 48 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 30 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 51 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 19 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 43 minutes ago
    same, it’s great for first pass LLM docs
• smokel 43 minutes ago
  Perhaps add "A systematic approach to technical documentation authoring" to the title?
• tedd4u 56 minutes ago
  Posted many times. Here's the most recent time from 2024 (also has most discussion).

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