https://www.youngju.dev/blog 천천히 올바르게. AI Researcher & DevOps Engineer Youngju's blog. GPU/CUDA, LLM, MLOps, Kubernetes AI workloads, and data engineering — plus mindset essays on confidence, routines, health, and sport psychology. ko fjvbn2003@gmail.com (Youngju Kim) fjvbn2003@gmail.com (Youngju Kim) Sun, 09 Aug 2026 00:00:00 GMT https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.en https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.en Diátaxis divides documentation into four kinds: tutorial, how-to, reference, and explanation. Yet most teams finish their adoption by creating four folders, and the actual problem stays exactly where it was. The real failure is not classification but mixing the four modes inside a single document. This post revisits why mixing collapses, working from the two axes the framework rests on, and lays out the compass that judges one paragraph at a time along with a work loop you can start running this week. Sun, 09 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) documentationdiataxistechnical-writingdeveloper-experienceinformation-architecture https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.ja https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.ja Diátaxisは文書をチュートリアル・ハウツー・リファレンス・説明の四種類に分けます。ところがチームのほとんどはフォルダを四つ作ったところで適用を終え、肝心の問題はそのまま残ります。本当の失敗は分類ではなく、ひとつの文書のなかで四つのモードを混ぜるときに起きるからです。混ざるとなぜ崩れるのかを、フレームワークが根拠にする二つの軸から辿り直し、段落単位で判定する羅針盤と、今週すぐ回せる作業ループまで整理しました。 Sun, 09 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) documentationdiataxistechnical-writingdeveloper-experienceinformation-architecture https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page Diátaxis는 문서를 튜토리얼·하우투·레퍼런스·설명 네 종류로 나눕니다. 그런데 팀 대부분은 폴더를 네 개 만드는 것으로 적용을 끝내고, 정작 문제는 그대로 남습니다. 진짜 실패는 분류가 아니라 한 문서 안에서 네 모드를 섞을 때 일어나기 때문입니다. 왜 섞이면 무너지는지를 프레임워크가 근거로 삼는 두 축에서 되짚고, 문단 단위로 판정하는 나침반과 이번 주에 바로 돌릴 수 있는 작업 루프까지 정리했습니다. Sun, 09 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) documentationdiataxistechnical-writingdeveloper-experienceinformation-architecture https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.zh https://www.youngju.dev/blog/productivity/2026-08-09-diataxis-four-modes-cannot-share-a-page.zh Diátaxis 把文档分成教程、操作指南、参考、说明这四类。可大多数团队建完四个文件夹就算落地完毕，真正的问题原封不动地留在那里。因为真正的失败不在分类，而发生在一篇文档里混用四种模式的时候。本文从这套框架赖以成立的两条轴出发，重新梳理混起来为什么会塌，并整理了以段落为单位作判定的罗盘，以及这周就能跑起来的工作循环。 Sun, 09 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) documentationdiataxistechnical-writingdeveloper-experienceinformation-architecture