🐷

ドキュメントの構成管理

2021/12/12に公開

ドキュメントの構成管理をするモチベーション

システムの構成管理をしよう!
コードの管理だけだと片手落ち
その仕様書っていつのもの?今のコードとあってる?
ドキュメントの版が確認できないと困る!

管理の要件

  • いつ、だれが、何を、なぜ変更したかがわかる
  • 過去の版と比較できる
  • 上記が楽だと嬉しい

管理方法

Gitで管理

  • how: plaintextをcommit, PR, マージする
  • pro: いつだれがなにを、という変更がわかりやすい
  • pro: ソースコードとの紐付けが行える
  • pro: ドキュメントレビューの仕組みを取り込みやすい
  • con: plaintext以外のものは管理しにくい(Officeなど)
  • con: 非エンジニアにとってハードルが上がる
  • con: クライアント等と共有しにくい

Dropboxで管理

  • how: Officeドキュメントなどに変更履歴ページを作る
  • how: 版ごとに別ファイルとして保存する
  • pro: 学習コストが低い
  • pro: 外部共有がしやすい
  • con: 差分を比較しにくい
  • con: ファイルが増える
  • con: ルールと手作業に依る要素が大きい

Google Driveで管理

  • how: googleドキュメント, スプレッドシートの変更履歴、版管理を用いる
  • pro: 学習コストが低い
  • pro: ファイルが一つ
  • pro: 外部共有がしやすい
  • con: 過去の版が消える可能性がある
  • con: 共同編集のコンフリクト、ファイルを分割すると履歴が終えない

ファイルの変更内容を確認する

NotePMで管理

  • how: NotePMに記載
  • pro: plaintextが基本だがファイル添付が可能
  • pro: ページごとに外部共有が可能
  • con: 有償

その他のツール

  • 個々に検討が必要

Discussion