システム活用法
Wikiの使い方 ― 版管理を活かしたナレッジの残し方
この記事でわかること
「あれ、どう決まったんだっけ?」「この用語、どういう意味?」。プロジェクトでは同じ質問が何度も繰り返されます。本システムのWikiは、プロジェクトの知識をページとして積み上げる場所です。更新のたびに版が残り、過去の版を確認できるため、安心して何度でも書き直せます。
Wikiのページ構成例
| ページ | 役割 |
|---|---|
| トップ(入口) | 主なページへのリンク集 |
| ルール・使い方 | 記録の書き方、ステータスの意味、連絡のルール |
| 決定事項一覧 | 日付順の決定事項 |
| 議事録 | 定例会ごとのページ |
| 用語集・手順書 | よく使う用語と、操作の手順 |
| 振り返り・教訓 | うまくいったこと・困ったこと |
Wikiに置くもの・置かないもの
| Wikiに置く | 別の機能に置く |
|---|---|
| 決定事項、ルール、用語集、手順書、議事録、振り返り | 対応が必要なこと → 課題・TODO |
| チームで少しずつ更新していく知識 | 全員への一時的なお知らせ → ニュース |
| ページとして読みやすく整理された情報 | 完成した文書ファイル → ファイル管理 |
版管理を活かすポイント
| 場面 | 版管理の活かし方 |
|---|---|
| ルールを変更した | 古い版が残るので、「いつから変わったか」を確認できる |
| 誤って内容を消してしまった | 過去の版を見て、内容を戻せる |
| 判断の経緯を説明したい | 決定事項ページの過去の版をたどれば、考え方の変化がわかる |
同時に編集したときの動き
同じページを、2人が同時に編集することがあります。あとから保存しようとした人は、「他の利用者がこのページを更新したため、保存できませんでした」と表示され、上書きされずに止まります。先に保存された内容が失われることはありません。
- 保存できなかったときは、慌てずに、最新の内容を開き直します。
- 自分が書いた内容は、保存前に別の場所(メモ帳など)にコピーしておくと、貼り直しが楽です。
- 議事録のように、同時に書き込みたいページは、書く人(書記)を1人に決めます。
ページへのコメント
Wikiのページには、本文の編集とは別に、質問やフィードバックを残せるコメント欄があります。本文を書き換えるほどではない指摘や、「ここが分かりにくい」という声は、コメントで受けます。コメントで出た内容を、書き手が本文に反映すると、ページが育ちます。
おすすめページのテンプレート
| ページ | 書く内容 |
|---|---|
| 決定事項一覧 | 日付・決定内容・決めた会議・関係する課題や変更要求の名前 |
| 用語集 | 用語・読み方・意味・使い方の例 |
| 手順書 | 目的・前提条件・手順(番号付き)・うまくいかないときの対処 |
| 振り返り・教訓 | よかったこと・困ったこと・次に活かすこと |
「育てるページ」にするコツ
- 完璧を待たずに書く:版が残るので、書きかけでも公開して、みんなで直していけば大丈夫です。
- 質問されたらWikiに書いて、リンクで答える:2回目からはリンクを送るだけになります。
- トップページを入口にする:主なページへのリンクをトップにまとめると、迷わずたどり着けます。
まとめ
Wikiは、プロジェクトの「共有された記憶」です。版管理があるから、失敗を恐れず書き足していける。決定事項や用語、手順を積み上げていけば、メンバーが入れ替わっても知識はプロジェクトに残ります。