docs-feedback-triage

ドキュメントへのフィードバックのトリアージ

このスキルを使うと、開発者向けドキュメントへのフィードバックを、妥当で実行可能かつ優先順位の付いた作業に変換できます。すべてのコメントを同じように扱うことを避けながら、ユーザーからの証拠を保持するのに役立ちます。

このスキルは、特に第8章「フィードバックの収集と統合」を中心に、Docs for Developers: An Engineer's Field Guide to Technical Writing を参考にしています。また、Christopher Gales と Splunk Documentation Team による The Product Is Docs: Writing Technical Documentation in a Product Development Group の第5章「顧客からのフィードバックとコミュニティ」、第18章「カスタマーサポートとの連携」、第20章「現場との連携」から、言い換えたガイダンスを追加しています。書籍の文章をユーザー向けの出力に転載しないでください。出典：https://link.springer.com/book/10.1007/978-1-4842-7217-6

クイックスタート

1. guidelines.md を読み込み、役立つ最小限のリファレンスセットを選びます。
2. フィードバックの提供元、影響を受けるドキュメント、ユーザーへの影響、対応の必要性、問題がドキュメント担当範囲かどうかを特定します。
3. 作業を推奨する前に、妥当性、実行可能性、重要度を確認します。
4. トリアージを一通り実施するには、workflows/triage-doc-feedback.md を使います。
5. フィードバックによってプロダクト、サポート、またはドキュメントの作業が変わる場合は、ユーザーまたは提供元チームにフォローアップします。

デフォルトの出力

フィードバックをトリアージする際は、次の項目を返します。

1. フィードバックの概要 - 提供元、影響を受けるドキュメント、ユーザーの種類、報告された問題。
2. 分類 - 妥当／無効／調査が必要、ドキュメント／プロダクト／サポートの問題か、重複状況。
3. 実行可能性 - 再現可能で、範囲が明確かつ修正可能な情報。
4. 優先度 - 重大度とその根拠。
5. 推奨アクション - ドキュメントの修正、担当先への振り分け、フォローアップ、または対応不要。
6. フォローアップ - ユーザーへの返信、担当者、収集する証拠。

目次

必要なこと	まず確認する項目
フィードバックチャネルを理解する	references/core/knowledge.md
トリアージルールを適用する	references/core/knowledge.md
トリアージの例を見る	references/core/knowledge.md
フィードバックをトリアージする	workflows/triage-doc-feedback.md
タスクに応じて振り分ける	guidelines.md

基本姿勢

• フィードバックは証拠であり、直接の指示ではありません。
• ドキュメントの問題と、プロダクト、サポート、価格設定、ポリシーの問題を区別します。
• ユーザーへの影響と修正可能性を基準に優先順位を付けます。
• 公開の場やコミュニティからのフィードバックは、サポートの兆候であると同時に、信頼を築く機会として扱います。
• ユーザーが実際の問題を報告するために時間を割いた場合は、フォローアップします。