MDC:Creating FAQs
出典: MDC
もし、FAQ の作成に冠する何らかの質問があれば、mozilla.dev.mdc で質問するか、deb@mozilla.com までメールを書いてください。(両方とも英語です。なお、両方とも英語版についてです。)
[編集] FAQ の作成方法
もし、FAQ を書こうと思ったなら、次の方法をとるのが最も簡単です :
- FAQ を書こうと思うトピックを決める
- トピックについての FAQ のページを探す。ページ名は "[Topic] FAQ" (たとえば、XPCOM FAQ など) にすべきです
- 存在していなければ、ここ にある説明に従って作成してください。
- あなたの質問とその答えを次の形式で追加してください。質問は 3 段目のヘッダに、答えはそれに続く通常の文章で。下のサンプルを参考にしてください。
- FAQ をサブセクションに分割した方がよいと思ったなら、気軽にそうしてください。しかしながら、大量の質問が並ぶのでない限り、あまり必要ではないでしょう。ゆくゆくは、FAQ がかなり溜まってきたときに、それらを小さな複数の文書に分解するでしょうから、あまり気にする必要はありません。
[編集] サンプル
[編集] 新規記事をどうやって書き始めればいいですか ?
最も簡単な方法は、自分のユーザページにリンクを作成し、そのリンクをたどることで記事の "編集" モードの画面に入る方法です。
ユーザページに行くには、wiki の最上部にある青いバーの中のあなたの名前をクリックしてください。もし、まだ何も追加していない場合、自由に記述できる入力フォームが表示されます。
ある記事へのリンクを作成するには、二重角括弧でその名前を囲んだものを書き込んでください。たとえば、[[これはサンプルです]] のように。これを保存すると、これはサンプルです のようにリンクに変換されます。