どんなに優れた製品でも、その製品のドキュメントが難解だとユーザーの拡大は難しいもの。そんなドキュメントの「正しい作成方法」について、ウェブアプリのビルドサービスを提供するDivioが解説しています。 The documentation system — Documentation system documentation https://documentation.divio.com/ よい製品でもよいドキュメントがなければユーザーは増えないと多くの人が認識しているにもかかわらず、「正しいドキュメント作成方法」を知らないために、ドキュメント作成に失敗している事例が後を絶たないとDivioは指摘。Divioはドキュメントを「実践的か、理論的か」「学習時に役立つか、作業時に役立つか」の2軸に当てはめ、「チュートリアル」「HowToガイド」「リファレンス」「説明・議論」の4つに分類しています。
![よい製品でもガイドやチュートリアルが難解だと使ってもらえない、ではドキュメントの正しい作成方法とは?](https://cdn-ak-scissors.b.st-hatena.com/image/square/666dd3479420938309aea93770e2554f95b680c2/height=288;version=1;width=512/https%3A%2F%2Fi.gzn.jp%2Fimg%2F2021%2F02%2F05%2Fthe-documentation-system%2F00.jpg)