Diátaxis

4 comments

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

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