Wiki

Wiki はプロジェクト単位でナレッジを蓄積・共有するためのドキュメント管理機能です。階層構造によるページ整理、タグ・キーワード検索、バージョン履歴管理など、チームの情報共有を効率化する機能を提供します。

画面構成

メイン画面

Wiki のメイン画面は以下の3つのエリアで構成されています。

エリア	説明
プロジェクト選択	Wiki を表示するプロジェクトを切り替えます
ページツリー	階層構造で整理されたページ一覧を表示します
最近の更新	最近作成・更新されたページを時系列で確認できます

詳細画面

選択したページの本文を表示します。ページのタグ、最終更新者・更新日時、バージョン履歴へのリンクも確認できます。

ページツリー

Wiki のページはツリー構造で管理されます。親ページの下に子ページを作成することで、情報を階層的に整理できます。

ツリーの操作

フォルダアイコンのページをクリックすると、子ページの一覧を展開・折りたたみできます
ページ名をクリックすると詳細画面に遷移します
ツリー上部の「新規作成」ボタンから、ルートレベルまたは任意の親ページ配下にページを追加できます

ページの検索・絞り込み

キーワード検索

ページツリー上部の検索ボックスにキーワードを入力すると、ページタイトルおよび本文を対象にリアルタイムで絞り込みを行います。

タグ検索

各ページに設定されたタグを使ってフィルタリングできます。タグ一覧から対象のタグをクリックすると、そのタグが付いているページのみ表示されます。複数のタグを選択すると AND 条件で絞り込まれます。

ページの作成

メイン画面右上の「新規作成」ボタンをクリックします
作成フォームが開きます
以下の項目を入力します

項目	説明
タイトル	ページの名前（必須）
親ページ	階層構造の親となるページを選択します。未選択の場合はルートレベルに作成されます
タグ	ページに関連するタグを入力します。複数設定可能です
ステータス	下書きまたは公開を選択します
本文	Markdown 形式でコンテンツを記述します

入力が完了したら「保存」をクリックします

ステータスについて

下書き（Draft）: 自分のみ閲覧可能な状態です。作成途中のページを一時保存するときに使用します
公開（Published）: プロジェクトメンバー全員が閲覧できる状態です

ページの編集

詳細画面右上の「編集」ボタンをクリックします
編集フォームが開きます
タイトル、タグ、ステータス、本文を編集します
「保存」をクリックして変更を確定します

保存のたびに新しいバージョンが自動的に記録されます。

バージョン履歴

履歴の確認

詳細画面の「バージョン履歴」リンクをクリックします
バージョン一覧画面が開きます
各バージョンの更新日時・更新者・変更概要が一覧で表示されます

過去のバージョンの閲覧

バージョン一覧の任意の行をクリックすると、そのバージョン時点での本文を閲覧できます。現在の公開バージョンとの差分を確認しながら内容を比較できます。

バージョンの復元

過去のバージョンの詳細画面から「このバージョンに戻す」ボタンをクリックすると、選択したバージョンの内容を現在のページに復元できます。復元操作も新しいバージョンとして記録されます。

プロジェクトとの連携

Wiki はプロジェクト単位でスコープが分かれています。

メイン画面上部のプロジェクト選択から、参照するプロジェクトを切り替えます
ページの作成・編集は、選択中のプロジェクトに紐づいて保存されます
別プロジェクトのページを閲覧する場合は、プロジェクトを切り替えてください

運用のヒント

階層設計のポイント

大分類（例：設計書、手順書、FAQ）をルートページとして作成し、その配下に詳細ページを整理するとツリーが見やすくなります
階層が深くなりすぎると検索性が下がるため、3〜4階層を目安にすることを推奨します

タグの活用

機能名、担当チーム、ドキュメント種別などをタグとして統一しておくと、横断的な検索が効率的になります
タグのルールをチーム内で事前に決めておくことで、検索精度が向上します

下書き機能の活用

執筆途中のページは下書き状態で保存し、内容が固まってから公開ステータスに変更することで、未完成の情報がチームに共有されるのを防げます