CtoS
システム活用法

Wikiの使い方 ― 版管理を活かしたナレッジの残し方

この記事でわかること

「あれ、どう決まったんだっけ?」「この用語、どういう意味?」。プロジェクトでは同じ質問が何度も繰り返されます。本システムのWikiは、プロジェクトの知識をページとして積み上げる場所です。更新のたびに版が残り、過去の版を確認できるため、安心して何度でも書き直せます。

Wikiのページ構成例

ページ役割
トップ(入口)主なページへのリンク集
ルール・使い方記録の書き方、ステータスの意味、連絡のルール
決定事項一覧日付順の決定事項
議事録定例会ごとのページ
用語集・手順書よく使う用語と、操作の手順
振り返り・教訓うまくいったこと・困ったこと

Wikiに置くもの・置かないもの

Wikiに置く別の機能に置く
決定事項、ルール、用語集、手順書、議事録、振り返り対応が必要なこと → 課題・TODO
チームで少しずつ更新していく知識全員への一時的なお知らせ → ニュース
ページとして読みやすく整理された情報完成した文書ファイル → ファイル管理

版管理を活かすポイント

場面版管理の活かし方
ルールを変更した古い版が残るので、「いつから変わったか」を確認できる
誤って内容を消してしまった過去の版を見て、内容を戻せる
判断の経緯を説明したい決定事項ページの過去の版をたどれば、考え方の変化がわかる

同時に編集したときの動き

同じページを、2人が同時に編集することがあります。あとから保存しようとした人は、「他の利用者がこのページを更新したため、保存できませんでした」と表示され、上書きされずに止まります。先に保存された内容が失われることはありません。

  • 保存できなかったときは、慌てずに、最新の内容を開き直します。
  • 自分が書いた内容は、保存前に別の場所(メモ帳など)にコピーしておくと、貼り直しが楽です。
  • 議事録のように、同時に書き込みたいページは、書く人(書記)を1人に決めます。

ページへのコメント

Wikiのページには、本文の編集とは別に、質問やフィードバックを残せるコメント欄があります。本文を書き換えるほどではない指摘や、「ここが分かりにくい」という声は、コメントで受けます。コメントで出た内容を、書き手が本文に反映すると、ページが育ちます。

おすすめページのテンプレート

ページ書く内容
決定事項一覧日付・決定内容・決めた会議・関係する課題や変更要求の名前
用語集用語・読み方・意味・使い方の例
手順書目的・前提条件・手順(番号付き)・うまくいかないときの対処
振り返り・教訓よかったこと・困ったこと・次に活かすこと

「育てるページ」にするコツ

  • 完璧を待たずに書く:版が残るので、書きかけでも公開して、みんなで直していけば大丈夫です。
  • 質問されたらWikiに書いて、リンクで答える:2回目からはリンクを送るだけになります。
  • トップページを入口にする:主なページへのリンクをトップにまとめると、迷わずたどり着けます。

まとめ

Wikiは、プロジェクトの「共有された記憶」です。版管理があるから、失敗を恐れず書き足していける。決定事項や用語、手順を積み上げていけば、メンバーが入れ替わっても知識はプロジェクトに残ります。