各 Chapter（トピック）の大まかな雛形・スタイルの決定

[monaqa]

議論の背景

• 書く内容は執筆者に裁量を持たせたい一方で、ある程度共通させたいものもある
  • たとえば執筆者の名前を最初？最後？に載せるとか
  • たとえば「この Chapter は この Chapter の内容を前提にしてますよ〜」みたいなのを書くとか
  • Chapter の概要や想定読者を冒頭に書くか？執筆者の好みに委ねるか？とか
• 記法も統一したほうがよさそうなものは統一したい
  • 「です・ます調」みたいな文の印象にかかわるスタイルとか
  • 「詳しくは Vim のヘルプのここを参照せよ」と伝えたいときはこう書こうね、みたいな取り決めとか

ここで決めたいこと

• 各トピックの雛形を作る
• 統一すべきスタイルとそうでないスタイルを決める

[monaqa]

マストで統一しなければならないもの

• 執筆者の名前・クレジットを書く場所
• 文体（「だ・である調」か「です・ます調」か）

なるべく統一したいもの

• Chapter の依存関係に関する記述
  • この Chapter はこの Chapter の知識を前提としてますよ、とか
  • この Chapter 読んでおくと理解に役立ちますよ、とか
• ヘルプへの参照を促す記法
  • たとえば自分の Vim の記事では文の末尾に "(:h iw)" と書いて「詳しくはヘルプの iw を参照」を表すことが多いです

統一してもいいかもしれないもの

• Chapter の概要や想定読者

こんなのも統一したいとか、逆に執筆者の裁量に委ねたいとかのご意見を募集します。