TIL about Diátaxis. diataxis.fr
There's no shortage of interesting things to learn.
There's no shortage of interesting things to learn.
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
September 24, 2026 at 3:58 PM
TIL about Diátaxis. diataxis.fr
There's no shortage of interesting things to learn.
There's no shortage of interesting things to learn.
d'expérience, lui faire écrire les specs dans un repo oú on les garde et ou on peut lui faire se référer à une "mémoire", ça rend le travail avec ces outils proche de la magie. genre "fais moi un site de docs diataxis en zensical avec le design system de la boîte à propos de la plateforme"
September 19, 2026 at 10:51 PM
d'expérience, lui faire écrire les specs dans un repo oú on les garde et ou on peut lui faire se référer à une "mémoire", ça rend le travail avec ces outils proche de la magie. genre "fais moi un site de docs diataxis en zensical avec le design system de la boîte à propos de la plateforme"
✍️ Hygiene skills: unslop, no-comments via the read-only comment-sicko agent, technical-writing (Diátaxis + Google style) and #TypeScript discipline, plus 21 single-lesson principle skills
September 1, 2026 at 10:00 AM
✍️ Hygiene skills: unslop, no-comments via the read-only comment-sicko agent, technical-writing (Diátaxis + Google style) and #TypeScript discipline, plus 21 single-lesson principle skills
🤖 OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
要約:
エンジニアリンググループUnit7の長谷川が、ビジネスサイドからの問い合わせをAIに回答してもらう取り組みについて紹介しています。Slackを通じてDevinに質問を投げかけ、回答を得る仕組みを構築しました。しかし、実際の問い合わせではAIの回答が思っていたものと異なることが多く、エンジニアの確認対応が増えてしまう問題に直面しました。そこで、ビジネスサイドの問い合わせデータや別チームの先行事例を参考に、回答の精度を高めるための設計を検討しました。また、チームで論点を持...
要約:
エンジニアリンググループUnit7の長谷川が、ビジネスサイドからの問い合わせをAIに回答してもらう取り組みについて紹介しています。Slackを通じてDevinに質問を投げかけ、回答を得る仕組みを構築しました。しかし、実際の問い合わせではAIの回答が思っていたものと異なることが多く、エンジニアの確認対応が増えてしまう問題に直面しました。そこで、ビジネスサイドの問い合わせデータや別チームの先行事例を参考に、回答の精度を高めるための設計を検討しました。また、チームで論点を持...
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
エンジニアリンググループUnit7の長谷川が、ビジネスサイドからの問い合わせをAIに回答してもらう取り組みについて紹介しています。Slackを通じてDevinに質問を投げかけ、回答を得る仕組みを構築しました。しかし、実際の問い合わせではAIの回答が思っていたものと異なることが多く、エンジニアの確認対
www.m3tech.blog
August 29, 2026 at 3:00 AM
🤖 OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
要約:
エンジニアリンググループUnit7の長谷川が、ビジネスサイドからの問い合わせをAIに回答してもらう取り組みについて紹介しています。Slackを通じてDevinに質問を投げかけ、回答を得る仕組みを構築しました。しかし、実際の問い合わせではAIの回答が思っていたものと異なることが多く、エンジニアの確認対応が増えてしまう問題に直面しました。そこで、ビジネスサイドの問い合わせデータや別チームの先行事例を参考に、回答の精度を高めるための設計を検討しました。また、チームで論点を持...
要約:
エンジニアリンググループUnit7の長谷川が、ビジネスサイドからの問い合わせをAIに回答してもらう取り組みについて紹介しています。Slackを通じてDevinに質問を投げかけ、回答を得る仕組みを構築しました。しかし、実際の問い合わせではAIの回答が思っていたものと異なることが多く、エンジニアの確認対応が増えてしまう問題に直面しました。そこで、ビジネスサイドの問い合わせデータや別チームの先行事例を参考に、回答の精度を高めるための設計を検討しました。また、チームで論点を持...
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
https://www.m3tech.blog/entry/2026/08/27/100000
https://www.m3tech.blog/entry/2026/08/27/100000
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイドからの問い合わせをAIに答えてもらう」取り組みを紹介します。 さて、社内のあるWebサービスには、エンジニアだけでなく、運用を担うビジネスサイドの担当者も関わっています。 担当者からは、クライアントからエスカレーションしてきた仕様の問い合わせが日常的に届いていて、エンジニアが都度答…
www.m3tech.blog
August 28, 2026 at 8:24 PM
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
https://www.m3tech.blog/entry/2026/08/27/100000
https://www.m3tech.blog/entry/2026/08/27/100000
#🔖テクノロジー
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイド...
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイド...
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
www.m3tech.blog
August 28, 2026 at 7:00 PM
#🔖テクノロジー
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイド...
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイド...
今日のAI関連記事
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 | エムスリーテックブログ
Devinによるビジネスサイドの問い合わせ対応自動化の取り組みについて。
単にコードを読ませるだけでなく、OKF形式のドキュメント整備やAIによる更新自動化など、AIが参照しやすい土台作りが重要であると述べています。
AIの性能向上よりも、情報の整理や人間による役割分担の設計、チーム間の連携こそが、精度の高い自動応答を実現する鍵であると伝えています。
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 | エムスリーテックブログ
Devinによるビジネスサイドの問い合わせ対応自動化の取り組みについて。
単にコードを読ませるだけでなく、OKF形式のドキュメント整備やAIによる更新自動化など、AIが参照しやすい土台作りが重要であると述べています。
AIの性能向上よりも、情報の整理や人間による役割分担の設計、チーム間の連携こそが、精度の高い自動応答を実現する鍵であると伝えています。
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 - エムスリーテックブログ
【Unit7ブログリレー4日目】（Unit7のメンバーが持ち回りで記事を書く企画です） エンジニアリンググループ Unit7（リサーチプロダクトチーム）の長谷川です。 AIコーディングが当たり前になって久しいですが、じゃあ実際どう使うのがいいのか、運用のやり方はまだ手探りです。今回はその手探りの1つ、「ビジネスサイドからの問い合わせをAIに答えてもらう」取り組みを紹介します。 さて、社内のあるWe
www.m3tech.blog
August 27, 2026 at 6:03 PM
今日のAI関連記事
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 | エムスリーテックブログ
Devinによるビジネスサイドの問い合わせ対応自動化の取り組みについて。
単にコードを読ませるだけでなく、OKF形式のドキュメント整備やAIによる更新自動化など、AIが参照しやすい土台作りが重要であると述べています。
AIの性能向上よりも、情報の整理や人間による役割分担の設計、チーム間の連携こそが、精度の高い自動応答を実現する鍵であると伝えています。
OKFやDiátaxisを活用してDevinによるお問い合わせ対応をしている話 | エムスリーテックブログ
Devinによるビジネスサイドの問い合わせ対応自動化の取り組みについて。
単にコードを読ませるだけでなく、OKF形式のドキュメント整備やAIによる更新自動化など、AIが参照しやすい土台作りが重要であると述べています。
AIの性能向上よりも、情報の整理や人間による役割分担の設計、チーム間の連携こそが、精度の高い自動応答を実現する鍵であると伝えています。
📦 nyoncode/laravel-knowledge-base v1.0.1
A knowledge base for Laravel — Diátaxis-shaped articles, search-first navigation, internal and public visibility, revisions and reader feedback. Ships Livewire 3/4 components and publishable Blade ...
🔗 https://github.com/NyonCode/laravel-knowledge-base
A knowledge base for Laravel — Diátaxis-shaped articles, search-first navigation, internal and public visibility, revisions and reader feedback. Ships Livewire 3/4 components and publishable Blade ...
🔗 https://github.com/NyonCode/laravel-knowledge-base
August 26, 2026 at 8:38 PM
📦 nyoncode/laravel-knowledge-base v1.0.1
A knowledge base for Laravel — Diátaxis-shaped articles, search-first navigation, internal and public visibility, revisions and reader feedback. Ships Livewire 3/4 components and publishable Blade ...
🔗 https://github.com/NyonCode/laravel-knowledge-base
A knowledge base for Laravel — Diátaxis-shaped articles, search-first navigation, internal and public visibility, revisions and reader feedback. Ships Livewire 3/4 components and publishable Blade ...
🔗 https://github.com/NyonCode/laravel-knowledge-base
Train a style-transfer skill on a codebase with acceptable style and / or use one of the Diataxis skills
August 13, 2026 at 6:58 AM
Train a style-transfer skill on a codebase with acceptable style and / or use one of the Diataxis skills
AnthropicのClaudeを活用したドキュメント管理手法が公開
エンジニアへの影響：コードベース構造からDiátaxis準拠の構成案を自動生成可能
https://dev.to/franrobprojects/how-to-build-and-maintain-skeleton-technical-docs-using-claude-with-copy-paste-prompts-196d
エンジニアへの影響：コードベース構造からDiátaxis準拠の構成案を自動生成可能
https://dev.to/franrobprojects/how-to-build-and-maintain-skeleton-technical-docs-using-claude-with-copy-paste-prompts-196d
How to Build and Maintain Skeleton Technical Docs using Claude (With Copy-Paste Prompts)
Learn how to leverage Claude to design a comprehensive documentation skeleton, map code to docs, and automate documentation coverage tracking.
dev.to
August 12, 2026 at 1:00 PM
AnthropicのClaudeを活用したドキュメント管理手法が公開
エンジニアへの影響：コードベース構造からDiátaxis準拠の構成案を自動生成可能
https://dev.to/franrobprojects/how-to-build-and-maintain-skeleton-technical-docs-using-claude-with-copy-paste-prompts-196d
エンジニアへの影響：コードベース構造からDiátaxis準拠の構成案を自動生成可能
https://dev.to/franrobprojects/how-to-build-and-maintain-skeleton-technical-docs-using-claude-with-copy-paste-prompts-196d
Diátaxis es una metodología que organiza el contenido técnico en cuatro categorías principales: tutoriales, referencias, guías y artículos.
https://norvik.tech/news/analisis-diataxis-tecnologias-actuales
https://norvik.tech/news/analisis-diataxis-tecnologias-actuales
August 10, 2026 at 1:06 AM
Diátaxis es una metodología que organiza el contenido técnico en cuatro categorías principales: tutoriales, referencias, guías y artículos.
https://norvik.tech/news/analisis-diataxis-tecnologias-actuales
https://norvik.tech/news/analisis-diataxis-tecnologias-actuales
the "maintained by humans" constraint is the whole product. if the skill only optimizes for what agents can parse, you just moved the debt one step down the pipeline. Diataxis for code smells is a smart angle.
August 6, 2026 at 8:25 PM
the "maintained by humans" constraint is the whole product. if the skill only optimizes for what agents can parse, you just moved the debt one step down the pipeline. Diataxis for code smells is a smart angle.
c'est marrant je viens de faire un skill tech-writer "diataxis" et j'ai mis claude-code sur une grosse stack terraform, le résultat est bluffant. Il me reste à la faire revoir par des gens qui ne connaissent pas la stack car je suis biaisé, mais le temps que ça fait gagner !
August 6, 2026 at 8:23 PM
c'est marrant je viens de faire un skill tech-writer "diataxis" et j'ai mis claude-code sur une grosse stack terraform, le résultat est bluffant. Il me reste à la faire revoir par des gens qui ne connaissent pas la stack car je suis biaisé, mais le temps que ça fait gagner !
I’m working on a set of Claude skills to generate clean, human-readable code (and therefore code that can be maintained by humans), and I’m starting to get some pretty nice results.
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
Last_one) { + unsigned char sha1[20]; + struct commit *cmit.
For code review. --zero-commit Output an all-zero hash in each format looks like this.
codeberg.org
August 6, 2026 at 7:20 PM
I’m working on a set of Claude skills to generate clean, human-readable code (and therefore code that can be maintained by humans), and I’m starting to get some pretty nice results.
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
Diátaxis는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇을 작성할지에 해당하는 콘텐츠…
news.hada.io
August 3, 2026 at 8:21 AM
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
Diátaxis는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇을 작성할지에 해당하는 콘텐츠…
news.hada.io
August 3, 2026 at 8:07 AM
Diátaxis - 기술 문서 작성을 위한 체계적 접근법 | GeekNews
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
news.hada.io/topic?id=32073
- Diátaxis는 사용자의 요구를 중심으로 기술 문서의 내용, 문체, 정보 구조를 체계적으로 설계하는 작성 프레임워크
- 문서의 목적에 따라 튜토리얼(학습), 방법 안내서(과제 완수), 기술 참조(정확한 정보), 설명(개념 이해)의 4가지 유형으로 분류해 체계화 (🧵1/2)
**Diátaxis - 기술 문서 작성을 위한 체계적 접근법**
- **Diátaxis** 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법
- 사용자의 요구를 **튜토리얼/방법 안내서/기술 참조/설명** 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함
- 무엇을 작성할지에 해당하는 **콘텐츠** , 어떻게 작성할지에 해당하는 문체, 어디에 배치할지에 해당하는 정보 구조 문제를 함께 다룸
- 가볍고 이해하기 쉬우며 특정 구현 방식에 제약을 두지 […]
- **Diátaxis** 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법
- 사용자의 요구를 **튜토리얼/방법 안내서/기술 참조/설명** 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함
- 무엇을 작성할지에 해당하는 **콘텐츠** , 어떻게 작성할지에 해당하는 문체, 어디에 배치할지에 해당하는 정보 구조 문제를 함께 다룸
- 가볍고 이해하기 쉬우며 특정 구현 방식에 제약을 두지 […]
Original post on mercur.ing
mercur.ing
August 3, 2026 at 1:35 AM
**Diátaxis - 기술 문서 작성을 위한 체계적 접근법**
- **Diátaxis** 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법
- 사용자의 요구를 **튜토리얼/방법 안내서/기술 참조/설명** 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함
- 무엇을 작성할지에 해당하는 **콘텐츠** , 어떻게 작성할지에 해당하는 문체, 어디에 배치할지에 해당하는 정보 구조 문제를 함께 다룸
- 가볍고 이해하기 쉬우며 특정 구현 방식에 제약을 두지 […]
- **Diátaxis** 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법
- 사용자의 요구를 **튜토리얼/방법 안내서/기술 참조/설명** 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함
- 무엇을 작성할지에 해당하는 **콘텐츠** , 어떻게 작성할지에 해당하는 문체, 어디에 배치할지에 해당하는 정보 구조 문제를 함께 다룸
- 가볍고 이해하기 쉬우며 특정 구현 방식에 제약을 두지 […]
Diátaxis - 기술 문서 작성을 위한 체계적 접근법
Diátaxis 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇...
Diátaxis 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇...
Diátaxis - 기술 문서 작성을 위한 체계적 접근법
Diátaxis 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇...
news.hada.io
August 3, 2026 at 1:00 AM
Diátaxis - 기술 문서 작성을 위한 체계적 접근법
Diátaxis 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇...
Diátaxis 는 문서 사용자의 서로 다른 요구를 기준으로 기술 문서의 내용/형식/구조를 설계하는 체계적 접근법 사용자의 요구를 튜토리얼/방법 안내서/기술 참조/설명 네 가지로 구분하고, 각 문서 유형의 역할과 관계에 따라 전체 문서 체계를 구성함 무엇...
August 2, 2026 at 8:03 PM
Diátaxis nails something most doc frameworks miss: tutorials aren't guides and how-tos aren't references. The four-quadrant split feels obvious once you see it but most teams still mash everything into "documentation" and wonder why nobody reads it.
August 2, 2026 at 7:35 PM
Diátaxis nails something most doc frameworks miss: tutorials aren't guides and how-tos aren't references. The four-quadrant split feels obvious once you see it but most teams still mash everything into "documentation" and wonder why nobody reads it.
Diátaxis [Discussion]
Diátaxis
Diátaxis
diataxis.fr
August 2, 2026 at 11:52 AM
Diátaxis [Discussion]
💡 Summary:
Diátaxisは、技術文書の作成を体系化する考え方で、学習用トTutorial、実用ガイド、技術リファレンス、解説の4つのニーズと対応する4形式を結びつけ、内容・文体・構成を最適化する。実践で効果が検証されており、文書作成者や保守者にも価値がある。実例として、GatsbyやCloudflareの導入事例が挙げられ、ユーザーの目的に沿った情報設計を支えた。
Diátaxisは、技術文書の作成を体系化する考え方で、学習用トTutorial、実用ガイド、技術リファレンス、解説の4つのニーズと対応する4形式を結びつけ、内容・文体・構成を最適化する。実践で効果が検証されており、文書作成者や保守者にも価値がある。実例として、GatsbyやCloudflareの導入事例が挙げられ、ユーザーの目的に沿った情報設計を支えた。
August 2, 2026 at 9:44 AM
💡 Summary:
Diátaxisは、技術文書の作成を体系化する考え方で、学習用トTutorial、実用ガイド、技術リファレンス、解説の4つのニーズと対応する4形式を結びつけ、内容・文体・構成を最適化する。実践で効果が検証されており、文書作成者や保守者にも価値がある。実例として、GatsbyやCloudflareの導入事例が挙げられ、ユーザーの目的に沿った情報設計を支えた。
Diátaxisは、技術文書の作成を体系化する考え方で、学習用トTutorial、実用ガイド、技術リファレンス、解説の4つのニーズと対応する4形式を結びつけ、内容・文体・構成を最適化する。実践で効果が検証されており、文書作成者や保守者にも価値がある。実例として、GatsbyやCloudflareの導入事例が挙げられ、ユーザーの目的に沿った情報設計を支えた。
August 2, 2026 at 9:44 AM