ステータス: 開発中
PR: https://github.com/wikinoapp/wikino/pull/923
概要
編集提案機能は、GitHubのPull Requestのように、ページに対して変更案を提出し、レビューを経て反映できる機能です。
直接編集する代わりに「こう変更してはどうでしょうか」という形で提案できます。
解決する問題
編集の心理的ハードル
「たぶんこの記述は間違っているけど、自分の修正も合ってるか自信が持てない」といった場面で、直接編集することへの不安や躊躇を解消します。
提案という形なら、最悪却下されても問題ないため、気軽に貢献できるようになります。
品質管理の難しさ
- 企業や組織のドキュメントで、誤った修正による影響を防ぎたい
- OSSプロジェクトの公式ドキュメントで、内容の正確性を保ちたい
- 技術仕様書やAPIドキュメントなど、正確性が重要な文書の品質を維持したい
利用シーン
個人利用
今後提供予定のMCPサーバーと組み合わせることで、生成AIにドキュメントの改善提案を作ってもらい、差分を確認して良さそうなら適用するというワークフローが実現できます。
Gitを使わずに、AIが生成したテキストの差分確認・適用・破棄ができるようになります。
チーム利用
- メンバー間でドキュメントの改善案を提案し合える
- レビュープロセスを通じて、ドキュメントの品質を保てる
- 責任の所在を明確にしながら、協働的な編集ができる
OSSプロジェクト
- 初心者コントリビューターが参加しやすくなる
- ドキュメントへの貢献のハードルが下がる
- レビューを通じて品質を維持しながら、多様な貢献を受け入れられる
メリット
心理的安全性の向上
- 「間違っているかも」という不安があっても提案できる
- 却下されても「提案」なので精神的ダメージが少ない (たぶん)
- 編集に慎重な人でも貢献しやすくなる
品質の維持・向上
- レビュープロセスにより、誤った情報の混入を防げる
- 複数の目でチェックすることで、より正確な内容になる
- 変更履歴が明確になり、誰がどんな提案をしたか追跡できる
協働作業の促進
- 外部からの貢献を受け入れやすくなる
- 建設的な議論を通じて、より良いドキュメントを作れる
- Git的なワークフローを、非技術者でも使えるようになる
「リクエスト」か？「提案」か？
最初「編集リクエスト」という名前にしようかと思ったが、「編集提案」のほうが気軽・柔らかい印象がある気がしたのでこちらを採用する。
- 「編集リクエスト」のニュアンス
- 「変更してください」というやや能動的なイメージ
- 受け手にアクションを求めるイメージ
- 編集を取り込むことを前提としたイメージ
- 「編集提案」のニュアンス
- 「こうしたらどうだろうか？」という控えめなイメージ
- 受け手に判断を委ねる受動的なイメージ
- あくまでアイデアを提示したまでで、取り込まれなくても問題ないというイメージ
機能要件 (ざっくり)
- トピック内でページの作成や既存ページの編集を提案できる
- 複数のページを一つの編集提案に紐付けできるようにしたい