編集を行う前に、変更の重要度に基づいてコンテンツのワークフローを異なる方法で扱っていることを理解することが重要です。
すべての新しい記事とサポート記事への大きな変更は Bugzilla を介したコンテンツリクエストを伴う必要がありますが (SUMO ナレッジベースのコンテンツリクエストの送信方法 を参照)、小さな変更はコンテンツリクエストなしで記事に直接投稿できます。
小さな変更と見なされるもの
以下は、私たちが小さな変更と見なすものです:
- 小さなタイプミスの修正
- 不要な空白の削除
- スペル、文法、句読点の間違いの修正
- Wiki マークアップの書式 (見出し、箇条書き、番号付け、スペース、インデント) の修正
- セクションを書き直すことなく、小さな事実に関する詳細 (例: バージョン番号、ボタンやメニューのラベル) を更新すること
- 元の文脈を変更することなく、セクションを更新し、既存のテンプレートに置き換えること
- 根本的なガイダンスを大幅に変更することなく、バージョンタグの追加や削除などのメンテナンス更新を含む、古くなった、またはサポートされていないコンテンツを修正すること
- サポートが終了した製品バージョンに関連するコンテンツとマークアップの削除
- ガイダンスや記事の構造を大幅に変更することなく、小さな手順の改良、簡潔な言葉遣い、またはアクセシビリティのための視覚的な手がかり (例: アイコンやメニューの参照の追加) を通じて、読みやすさや明確さを向上させること
- リンク切れの更新、名前が変更されたサポート記事へのリンクの更新、または同じターゲットコンテンツを持つリンクの更新
- Mozilla のサポートコンテンツ基準に合わせるためのトーンの調整
- 古い UI のスクリーンショットを更新版 (最大 3 枚まで) に置き換えること
- キーワードの更新
- 検索概要の追加または更新
大きな変更と見なされるもの
ナレッジベース (KB) サポート記事への大きな変更には、製品関係者との調整を促進し、コンテンツの正確性を確保し、進捗を追跡し、部門横断的なコラボレーションをサポートするために Bugzilla リクエスト が必要です。
以下は、私たちが大きな変更と見なすものです:
- 新しい記事の作成
- 製品関係者からの検証や彼らとの緊密な連携を必要とする変更。これには以下が含まれます:
- リリース準備に関連する更新
- 大幅なコンテンツの追加 (新しい手順、FAQ、トラブルシューティングの手順など)
- 古いスクリーンショットの置き換え、または 3 枚を超える新しいスクリーンショットの追加
- コンテンツチームによるレビューを必要とする、ユーザーガイダンスや記事の構造に影響を与える大幅な変更。これには以下が含まれます:
- 既存のセクションの削除
- 段落またはセクションの広範囲にわたる書き直し
- 大規模な書式設定や構造の変更 (複数のセクションの再編成や記事の流れの変更など)
- 記事の範囲や意図の変更
- スクリーンキャスト、GIF、動画の更新、追加、削除
- アンカーリンクや記事のナビゲーションに影響を与える可能性のあるセクション見出しの書き直しまたは名前の変更
ナレッジベースへの貢献についてさらに詳しく知るには、ナレッジベースに貢献する方法 をご覧ください。