共同オーサリング
人が必要とする説明から始める。
まず表現力のある共有文書を書きます。概念に識別、再利用、管理が必要になった時点で構造を加えます。
- 01
- 02
再利用可能なナレッジオブジェクト
重要な概念には一度だけ名前を付ける。
サービス、システム、チーム、コンポーネント、ランブック、SLO、意思決定は安定した識別子を持ち、文書間で参照できます。
- 03
セマンティック図
配置と意味を混同せずに関係をモデル化する。
型付きオブジェクトと宣言された関係を、読みやすさのためだけの接続線から分離します。
- 04
Document Graph
つながるコンテキストをたどる。
文書、オブジェクト、図、参照、関係が、ナレッジの出所を保つナビゲーション可能なグラフを形成します。
- 05
セマンティック変更レビュー
変更の意味をレビューする。
更新を受け入れる前に、影響を受ける参照、関係の変更、バージョン移動、未解決の影響を確認します。
- 06
Knowledge ContractsとLiving Bindings
宣言されたナレッジと観測コンテキストをつなぐ。
Contractが期待される構造を定め、Bindingが出典付き外部コンテキストを、宣言を上書きせずに並べます。
- 07
ポータブルナレッジ
検査と移転が可能な状態を保つ。
バージョン付きパッケージが、内容、識別子、関係、来歴を決定的な形式で保持します。
セマンティック図
配置と意味を混同せずに関係をモデル化する。
型付きオブジェクトと宣言された関係を、読みやすさのためだけの接続線から分離します。
チームが日々説明しているシステムをモデル化しましょう。
Topoloomが文章、オブジェクト、図、運用ナレッジ、レビューをどうつなぐかをご覧ください。