そのための基盤ドキュメントの構造化¶ドキュメントの効率的な維持管理の観点から、ドキュメントの構造化については今後非常に重要になってくると考えられる。本稿では「ばらばらになっているものを、一定の基準に従い論理立てて整理すること」と定義する。一般的に「ドキュメントの構造化」においては、下記の3つの「構造化の基本要素」が利用されている。(見出し)文章ブロックに「見出し」を付けることは、その文書全体におけるその文章ブロックの「責務の明確化」を行なうことであり、最も基本的な構造化作業である。(目次)ドキュメントの「目次」を作成することは、そのドキュメント全体をツリー構造で表現することであり、ドキュメントの全体設計という最も重要な構造化作業である。(クロスリファレンス)ドキュメントに「クロスリファレンス」を作成することは、ツリー構造で表現された文書内部において、関係のある文章ブロック間にネットワーク構造を構築することであり、ネットワークの集中するところにそのドキュメントの価値的な比重があることを表現する付加価値の高い構造化作業と考えられる。Noteドキュメント構造化における「文章ブロック」は、文書ツリー構造における末端ノードとなることから、本稿では以下「情報ノード」と表現する。追加したものが、運用ドキュメントにおける一般的な共通構造である。よるテーマモデル毎の構造が表現されると考えられる。「状態」の構造その対象が「時間軸上の一点における認識世界を示す」という特性上、森羅万象に及びかねないため、その構造モデルは検討できていないのが現状である。構造化による効果は以下の3点が考えられる。中長期的には書き手がドキュメントを書きやすくなる。逆説的な説明になるが、構造化ドキュメントを記述するには、そのドキュメント対象を構造化して捉えなおさなければならず、構造化して捉えなおした対象を構造的に記述することは容易になると考えられる。Note見出し付け時に各情報ノードの責務を明確化することにより重複を回避しやすくなる、情報ノードを追加時などの目次の更新において内容の過不足を把握する機会が増える、などの効果が考えられる。読み手がドキュメントを読みやすくなる。目次のわかりやすい本は一般的に読みやすいと言われているが、適切に構造化されたドキュメントはドキュメント対象を構造的に理解することを可能とし、時間が限られる読み手にとって対象の取捨選択を容易にする効果がある。Note取捨選択が容易であることは、利用工数の削減をもたらし、反復利用を促進し、利用機会の増大に繋ると考えられる。主観ドキュメントと客観ドキュメントのセグメントを明確に分離することが可能になる。構造化されたドキュメントでは、全てを人が手で記述する必要がある主観ドキュメントのセグメントとシステマティックに生成されるべき客観ドキュメントのセグメントを明確に分離することが可能になると考えられる。Note運用ドキュメントの今後を考える上で、作成工数の抑制と効率的な維持管理を実現するための「システマティックなドキュメント生成」という視点は重要になる。セマンティック技術の再評価、情報の「マッシュアップ」技法など、IT技術によるIT技術現場のためのドキュメント技術の実践拡大が今後強く期待される。以上、構造化による想定効果について述べてきたが、書き手にとって最も大きい効果は、構造化されたドキュメントは、他者への引き継ぎが比較的容易と考えられる点かもしれない。運用ドキュメントは「完成したら終わり」ではない。完成してからがスタート。(使いながら作る事も珍しくない)更新や廃止など、ライフサイクルを意識した継続的な維持管理が必要となる。「ライフサイクル」には「お葬式」も重要ドキュメントの廃止が明示的に行なわれることは少ない。不要なドキュメントが廃止されないことで、無用のトラブルを生じたり、全体の保守性を下げ無駄な保守工数がかかる可能性がある。廃止すべきドキュメントや、更新されていないドキュメントを洗い出す「定期的な棚卸し」が「ドキュメントのライフサイクル」では重要となる。実現できそうな気がしてきた。(仮称))誰でも入力できること。システム(UNIX)のアカウント/スキルが不要であること。アウトプットをイメージできると嬉しい。スタイルシートを呼び込むとか。)バージョン管理できる。過去との差分がわかる。複数人で無理なくメンテナンスできる。キーワード置換ができる(gitはできない)。ユーザから隠蔽(存在を意識しない)できると嬉しい。シェル)のアカウント/スキルが不要だと嬉しい。変更点(4W1H)はバージョン管理システムに残るが、そこに残りにくい意図やきっかけなど(Why)はチケットシステムに残る可能性が高い(かも)。)マスタデータを各種フォーマットに簡単に変換できる。HTMLに変換できる。RESTfulによる所在固定化)PDF/pptに変換できる。(ミーティングや成果物用)ePubに変換できる。扱えると、ものすごく嬉しい。(これは書くのも大変か?)日本語に完全対応だと非常に嬉しい。ユーザから隠蔽(存在を意識しない)できると嬉しい。「簡単に」書けて「誰でも」使える「正確な」ドキュメントが求められる。仮説」の図が画像なのはマケのような気がする。