コントリビューターが新しい記事のコンテンツを執筆する前に、説明を記入する必要があります。このように記事を分類することで、読者は記事をより簡単に見つけられるようになります。その方法を以下に示します。
タイトル
記事のタイトルは、読者に何を示す記事なのかを明確に説明するべきです。タイトルの先頭に How (方法) という単語を付けることは避けてください。ほとんどの記事は手順のガイダンスを提供するため、各タイトルの先頭に How を付けると、アルファベット順の整理が難しくなり、煩雑になります。例えば、「How to change your New Tab background (新しいタブの背景を変更する方法)」の代わりに、「Change your New Tab background (新しいタブの背景を変更する)」を使用してください。
記事の種類ごとのタイトルの要件
記事の種類ごとに、ユーザーにとってタイトルが明確で役立つものになるように、特定の要件があります。
- 操作方法の記事: 動詞を使用してタスクを明確に示します。例: Change Your New Tab Background (新しいタブの背景を変更する)。
- 解説記事: 説明する概念や機能に焦点を当てます。例: Understand Firefox Extensions (Firefox の拡張機能を理解する)。
- トラブルシューティング記事: 問題を説明し、アクション指向の解決策を含めます。
- FAQ 記事: トピックやよくある質問を明確に記述します。例: Mozilla VPN - FAQ。
それぞれの記事の種類の具体的な執筆ガイドラインについては、以下を参照してください:
- "How-to" article type best practices
- "About" article type best practices
- "Troubleshooting" article type best practices
- "FAQ" article type best practices
スラッグ
スラッグは記事へのリンクです。短くしてください。「Joining a Conversation」のスラッグは「joining-conversation」のようになります。
カテゴリー
この記事が何をするためのものかに基づいてカテゴリーを選択してください。この記事は読者に Mozilla 製品で何かをする方法を示していますか？ を選択してください。トラブルシューティングの問題に役立ちますか？ を選択してください。
製品
この記事は何に関連していますか？ Firefox に関連していますか？ Firefox for iOS ですか？ Firefox for Android ですか？ 該当するものをすべて選択してください。
トピック
にはドロップダウンメニューがあります。記事が Firefox に関連している場合は、Firefox のドロップダウンメニューをクリックしてください。次に、記事が Firefox のどの部分に適用されるか (、、 など) をクリックします。該当するものをすべて選択してください。
関連文書
ほとんどの記事は他の記事と関連しています。関連する記事の名前の冒頭を入力してください。Kitsune がクリックできる関連する記事を自動的に見つけます。
キーワード
キーワードは、記事の検索結果の要約に含まれていない用語を追加することで、検索結果を改善できます。
検索結果の要約
要約は、ユーザーが適切な場所にいるかどうかを判断するのに役立つように、記事の内容を垣間見せるものです。概念のテキストによる概要や定義を提供し、FAQ を紹介してください。検索エンジンは 140 文字を超えると切り捨てることがあるため、要約は 140 文字に制限してください。
ナレッジベースのガイドライン
ナレッジベースへの貢献に関する詳しいガイドラインは、こちら で見つけられます。
