logo

Diátaxis

Posted by ryanseys |3 hours ago |7 comments

conradludgate 3 hours ago[2 more]

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.

Hnrobert42 3 hours ago[1 more]

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!

smokel 3 hours ago

Perhaps add "A systematic approach to technical documentation authoring" to the title?

tedd4u 3 hours ago

Posted many times. Here's the most recent time from 2024 (also has most discussion).

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