
<chapter id="styleguide">
<title><!--LDP Style Guide-->LDP スタイル・ガイド</title>

  <sect1 id="sg-subject">
    <title><!--Deciding on a Subject-->主題を決める</title>

      <!--
      <para>
        Before you begin writing a HOWTO, it is essential that
        you determine what subject area you will cover. It is best if the
        subject area is:
      </para>
      -->
<para>HOWTO を書き始める前に、カバーしようとする主題の範囲を明確にする
ことが先決です。主題の範囲は、以下の条件に合致することがベストです。</para>
      
      <orderedlist>
        <listitem>
          <formalpara>
            <title><!--Not too broad, and not too narrow.-->
                   広すぎず、狭すぎず</title>
              <!--
              <para>
                Try to cover too much information,
                and you may sacrifice depth. It is better to cover a
                small subject area fully than to cover a large subject
                area poorly.
                Linux tools are known for doing exactly one
                thing and doing that one thing <emphasis>well</emphasis>. 
                Similarly, your HOWTO should cover one subject and cover it
                <emphasis>well</emphasis>.
              </para>
              -->
<para>広範な情報をカバーしようとすると、深さが犠牲になります。広い主題を
貧弱にカバーするよりも、狭い主題を充分にカバーするほうがベターです。
Linux のツール類は、ひとつの仕事しかしませんが、それを的確にこなすことで
有名です。同様に、HOWTO でもひとつの主題を的確にカバーするようにしてください。
</para>
          </formalpara>

          <!--
          <para>
            If your subject matter is very small, it might be better
            included as part of another HOWTO. This makes it easier
            for readers to find the HOWTO they need. Search the LDP repository
            for HOWTOs on related topics, and see if you could place
            your information in an existing HOWTO.
          </para>
          -->
<para>主題となる事柄が非常に狭い場合は、他の HOWTO の一部として作成するほうが
いいかもしれません。そうすれば、読者は必要とする HOWTO を見つけやすくなります。
関連するトピックの HOWTO を LDP リポジトリで検索して、既存の HOWTO のなかに
これから書こうとする情報を追加できる場所がないか確認してください。</para>
        
          <!--
          <para>
            How much is too much?
            How little is too little? That depends on the subject
            you chose, your mastery of that subject, and many other
            factors. Just keep this admonition in mind, and use good judgement.
          </para>
          -->
<para>どの程度だと書きすぎか、どの程度だと書き足りないかは、選んだ主題にも
よりますし、その主題にどれだけ習熟しているかなどにもよります。そのことを
念頭に置いて、適切な判断を下してください。</para>

        </listitem>
        
        <listitem>
          <formalpara>          
            <title><!--Clearly defined.-->主題は明確に</title>

            <!--
            <para>
              Know before you begin exactly where the boundaries of your
              subject area lie. You should not cover the same ground as another
              HOWTO, and you should try not to leave gaps between your HOWTO
              and related HOWTOs, either.
            </para>
            -->
<para>書き始める前に、主題となる領域の境界をどこに据えるかを正確に意識する
ようにしてください。他の HOWTO と同じ領域をカバーするべきではありませんし、
作成する HOWTO と関連する既存の HOWTO との間になるべくギャップを作らないよう
にしてください。</para>
          </formalpara>
        </listitem>

        <listitem>
          <formalpara>
            <title><!--Undocumented-->新しい主題であること</title>
            
            <!--
            <para>
              Before writing on a particular subject, check other HOWTOs at 
              the LDP, and see if the topic is already documented. If it is, 
              refer to the other HOWTO instead of rewriting documentation that 
              already exists.
              Don't reinvent the wheel.
            </para>
            -->
<para>特定の主題について書く前に、LDP で他の HOWTO をチェックして、おなじ
トピックが既に文書化されていないか確認してください。もし既にあるなら、
同じ文書をふたつ作るよりも、既存の文書を活用するようにしてください。</para>
          </formalpara>
      
          <!--
          <para>
            If the HOWTO already in place is insufficient, or needs updating, 
            contact the author and offer to help. LDP authors are usually nice
            folks.
            After all, they put in their own valuable time to help people they
            don't even know. And, they appreciate your help. But, please, don't
            duplicate work. It causes confusion for everyone.
          </para>
          -->
<para>もし既存の HOWTO では不十分な場合や、更新が必要な場合は、その著者に連絡
して、協力を申し出るようにしてください。LDP の著者は、たいていいいヤツです。
結局、彼らは、知りもしないひとを助けるために貴重な時間を割いたわけです。
ですので、申し出は快く受け入れてくれるでしょう。ただ、どうか作業結果は
一本化してください。でないと、皆が混乱します。</para>
        </listitem>
        
        <listitem>
          <formalpara>
            <title><!--Pre-approved by the LDP-->
                    LDP で事前に承認されること</title>
            
            <!--
            <para>
              Before you proceed with your HOWTO, post to the ldp-discuss list
              and get some feedback from other LDP volunteers. Checking with 
              the
              list <emphasis>before</emphasis> you begin can save you headaches
              <emphasis>later</emphasis>.
              The author speaks from experience.
            </para>
            -->
<para>HOWTO 作成に入る前に、ldp-discuss メーリングリストにその旨連絡して、
LDP ボランティアからのフィードバックを取るようにしてください。<emphasis>事前
に</emphasis>メーリングリストをチェックしておくと、<emphasis>後で</emphasis>
悩まずにすみます。経験者の談です。</para>
            
          </formalpara>

          <!--
          <para>
            It is a really good idea to join the ldp-discuss list, and follow
            it regularly, even if you never post. It's a good way to stay 
            current
            on the activities, needs, and policies of the LDP. Although the LDP
            volunteers are here to assist you, it is ultimately your 
            responsibility to learn these policies, and to follow them.
          </para>
          -->
<para>ポストしなくとも、ldp-discuss メーリングリストに参加して、定期的に
フォローしておくのは、とてもいいことです。LDP の活動やニーズ、ポリシー
の現状を知るのに役立ちます。LDP ボランティアはむろん援助は惜しみませんが、
LDP のポリシーを学び、それに従うかどうかは、最終的にあなたがお決めになる
ことです。</para>
        </listitem>
      </orderedlist>
  
  </sect1>
  
  <sect1 id="sg-outline">
    <title><!--Developing an Outline-->アウトラインを作成する</title>
    
    <!--
    <para>
      Before you actually begin writing, prepare an outline.
      An outline will help you get a clear picture of the subject matter,
      and allow you to concentrate on one small part of the HOWTO
      at a time.
    </para>
    -->
<para>実際に書き始めるにあたり、事前にアウトラインを作成してください。
アウトラインを準備しておくと、主題についての明確なイメージを持つことが
できるようになりますし、その時々で、HOWTO の細かな部分に集中できます。</para>
    
    <!--
    <para>
      Unless your HOWTO is exceptionally small, your outline will probably
      be multilevel.
      When developing a multilevel outline, the top level should contain 
      general
      subject areas, and sub-headings should be more detailed and specific.
      Look at each level of your outline independently,
      and make sure it covers all key areas of the subject matter. Sub-headings
      should cover all key areas of the heading under which they fall.
    </para>
    -->
<para>極端に短い HOWTO でない限り、アウトラインはおそらく何段階かのレベルに
わかれるはずです。階層を持ったアウトラインを作成する場合は、主題に関する
一般的な事柄が最上位に含まれ、サブセクションに特定の詳しい事柄が来るように
してください。個々のアウトラインのレベルを個別に眺めて、主題についての主要
領域がすべてカバーされているかどうかを確認してください。サブセクション全体
で、セクションに含まれるべきすべての主要領域がカバーされるようにしてください。
</para>

    <!--
    <para>
      Each item in your outline should logically follow the item before it,
      and lead into the item it precedes. For example, a HOWTO about a 
      particular
      program shouldn't have a section on <emphasis>configuration</emphasis>
      before one on <emphasis>installation</emphasis>.
    </para>
    -->
<para>アウトラインの個々の項目は、前の項目を受け、後の項目を導くような
論理関係になるようにしてください。たとえば、特定のプログラムに関する HOWTO 
の場合、あらかじめ<emphasis>インストール</emphasis> のセクションを書かずに、
いきなり<emphasis>設定</emphasis>のセクションを作らないようにしてください。
</para>
    
    <!--
    <para>
      When you are comfortable with your outline, look over it once more,
      with a critical eye. Have you covered every relevant topic in
      sufficient detail? Have you wandered beyond the scope of the HOWTO?
      You might want to show it to someone else, and ask for feedback. 
      It's much easier to reorganize your
      HOWTO at the outline stage than it will be later. Consider submitting
      the outline to the ldp-discuss list for more feedback.
    </para>
    -->
<para>アウトラインができたら、今度は、それを批判的な目でもう一度眺めてくださ
い。すべての関連トピックを適当な詳しさでカバーしているでしょうか？ HOWTO の
射程外のことが書かれていませんか？ それを誰かに見せて、意見を求めるといいかも
しれません。書き始めた後よりも、アウトラインの段階の方が自分の HOWTO の全体像
を掴みやすいものです。多くのフィードバックが欲しいときは、アウトラインを 
ldp-discuss メーリングリストに投稿することも考えてください。</para>
    
    <note>
      <!--
      <para>
        You might have noticed a theme developing here.
        Just like Free software, Free documentation is best when you
        <quote>release early, release often.</quote> The ldp-discuss list 
        includes
        many experienced LDP authors, and you would be wise to seek their
        advice when making decisions about your HOWTO.
      </para>
      -->
<para>ここで述べようとしているテーマにもう気付いた方もいらっしゃるでしょう。
フリーソフトウェアと同様に、フリードキュメントも、<quote><ulink 
url="http://cruel.org/freeware/cathedral.html#4">はやめのリリース、
しょっちゅうリリース (release early, release often)</ulink></quote> がベスト
です。
ldp-discuss メーリングリストには、LDP 文書作成の経験者が大勢いますから、
HOWTO 作成時に迷うことがあったら、アドバイスを求めるといいかもしれません。
</para>
    </note>

    <para>
      <!--Remember Linus' Law:-->
      Linus の法則を思い出しましょう。
    </para>
    
    <blockquote><attribution>Eric S. Raymond</attribution>
      <para>
        <quote><!--Given enough eyeballs, all [typos] are shallow.-->
<ulink url="http://cruel.org/freeware/cathedral.html">
目玉の数さえ充分あれば、どんな typo も深刻ではない。
</ulink>
<footnote>
 <para>上記 2 つの quotation は、<ulink 
url="http://www.post1.com/home/hiyori13/jindex.html">
山形浩生</ulink>さんの翻訳からお借りしました。</para>
</footnote>
        </quote>
      </para>
    </blockquote>
    
    <para>
      <!--(With apologies to Mr. Raymond.)-->
      (Mr. Raymond ごめんなさい。)
    </para>

    <!--
    <para>
      FIXME: Need a reference to the "standard" HOWTO layout, for 
      topic areas such as Credits, License, Copyright, etc., etc.
    </para>
    -->
<para>FIXME: クレジットやライセンス、コピーライトなどなどのトピックに関する
"標準的" なレイアウトを提示すること。</para>
  </sect1>
  
  <sect1 id="sg-writingstyle">
    <title><!--Writing the Text-->文章を書く</title>
    
    <!--
    <para>
      At this point, your HOWTO has been organized, and bits of raw information
      have been collected, documented, and inserted into the outline.
      Good news: You're past the
      midpoint; it's all downhill from here. 
    </para>
    -->
<para>この時点で、HOWTO の枠組が決まり、未加工の断片的な情報が集められ、
文書化され、アウトラインに組み込まれていると思います。よいニュースです。
これで中間地点を過ぎました。あとは下り坂です。</para>

    <!--
    <para>      
      Your next challenge is to
      massage all of the raw data you've collected into a readable,
      entertaining, and understandable whole.
    </para>
    -->
<para>次にチャレンジするのは、これまで集めた生のままのデータ全部に
マッサージを施しながら、読んで、楽しんで、理解できるような完成品に仕上げる
ことです。</para>
    
    <!--
    <para>
      It has taken quite a bit of work to get to the point where you can
      actually start writing, hasn't it? Well, the hard work begins to pay
      off for you now. At this stage, you can begin to really use your
      imagination and creativity to communicate this heap of dry, 
      boring information in 
      your own unique way.
    </para>
    -->
<para>実際に文章を書き始めることができる地点までたどり着くには、大変な作業が
必要だったと思います。しかし、そのハードワークが報われる時が来ました。この
段階では、あなた独自の方法で無味乾燥な大量の情報を吟味して、イマジネーション
と独創性を発揮できます。</para>
    
    <!--
    <para>
      It is beyond the scope of this document to provide a comprehensive
      guide to effective writing, so I won't try to go beyond the basics. 

      In the <quote><link linkend="sg-references" 
      endterm="sg-references.title"></link></quote>
      section, you will find a list of resources that cover the subject
      better than this guide could hope to. Consult them, and follow their
      advice.
    </para>
    -->
<para>効率よく文章を書く方法全般を解説することは、この文書の範疇を越えるので、
基本的なことだけを説明しようと思います。<quote><link linkend="sg-references" 
endterm="sg-references.title"></link></quote> のセクションで、この文書などより
も的確にこれを扱った文献を紹介しています。それらの文献をあたって、アドバイス
に従ってください。</para>
    
    <!--
    <para>
      For starters, here is some good advice from 
      <ulink url="http://www.resort.com/~prime8/Orwell/patee.html">
      <citetitle>Politics and the English Language</citetitle></ulink>:
    </para>
    -->
<para>まずは、<ulink url="http://www.resort.com/~prime8/Orwell/patee.html">
<citetitle>Politics and the English Language</citetitle></ulink> から
いくつかアドバイスを紹介します。</para>
    
    <blockquote>
      <attribution>George Orwell</attribution>
    
      <!--
      <para>
        A scrupulous writer, in every sentence that he writes, will ask himself
        at least four questions, thus:
      </para>
      -->
<para>注意深いライターは、文章を一行書くたびに、少なくとも次の 4 つのことを
自問する。</para>
      
      <orderedlist>
        <listitem>
          <para>
            <!--What am I trying to say?-->
            自分は何を言おうとしているんだろう？
          </para>
        </listitem>

        <listitem>
          <para>
            <!--What words will express it?-->
            どんな言葉でそれを表現できるだろう？
          </para>
        </listitem>

        <listitem>
          <para>
            <!--What image or idiom will make it clearer?-->
            どういうイメージや言い回しを使うともっとはっきりするだろうか？
          </para>
        </listitem>

        <listitem>
          <para>
            <!--Is this image fresh enough to have an effect?-->
            このイメージは、新鮮な効果を発揮するだろうか？
          </para>
        </listitem>
      </orderedlist>

      <para>
        <!--And he will probably ask himself two more:-->
        おそらくは、次のふたつも自問するだろう。
      </para>
      
      <orderedlist>
        <listitem>
          <para>
            <!--Could I put it more shortly?-->
            もっと端的に表現できないだろうか？
          </para>
        </listitem>

        <listitem>
          <para>
            <!--Have I said anything that is avoidably ugly?-->
            陳腐で余計なことを言っていないだろうか？
          </para>
        </listitem>
      </orderedlist>
      
      <!--
      <para>
        ...One can often be in doubt about the effect of a word or phrase, 
        and one needs rules that one can rely on when instinct fails.
        I think the following rules will cover most cases:
      </para>
      -->
<para>...言葉の効果を計りかねるのはよくあることです。それゆえ、直観をあてに
できないときに、頼れるルールが必要になる。たいていのケースは次のルール
でカバーできると、わたしは思う。</para>
      
      <orderedlist>
        <listitem>
          <para>
            <!--
            Never use a metaphor, simile, or other figure of speech which you 
            are used to seeing in print.
            -->
            普段目にすることが多い隠喩や直喩、その他の比喩的表現は使わない
            こと。
          </para>
        </listitem>

        <listitem>
          <para>
            <!--Never use a long word where a short one will do.-->
            簡単な単語を使えるときは、難しい単語を使わないこと。
          </para>
        </listitem>

        <listitem>
          <para>
            <!--If it is possible to cut a word out, always cut it out.-->
            使わなくてもいい単語は、決して使わないこと。
          </para>
        </listitem>

        <listitem>
          <para>
            <!--Never use the passive where you can use the active.-->
            能動態が使える場合に、受動態を使わないこと。
          </para>
        </listitem>

        <listitem>
          <para>
            <!--
            Never use a foreign phrase, a scientific word, 
            or a jargon word if you can think
            of an everyday English equivalent.
            -->
            外国語のフレーズ、科学用語、専門用語の類は、日常英語のなかで
            該当する語句が思い浮かぶ場合は使わないこと。
          </para>
        </listitem>

        <listitem>
          <para>
            <!--
            Break any of these rules sooner than say anything outright 
            barbarous.
            -->
            以上のルールをひとつでも破ると、そのとたんに、言葉は野暮なものに
            なる。
          </para>
        </listitem>
      </orderedlist>
      
    </blockquote>

    <!--    
    <para>
      And, from a purely stylistic point of view, I believe that 
      the first-person perspective of many HOWTOs adds to their charm,
      an attribute most documentation in other forms sorely lacks.
      Don't be afraid to speak for yourself, use the word <quote>I</quote>,
      or describe personal experiences and opinions.
    </para>
    -->
<para>それから、純粋にスタイルの観点から言うと、多くの HOWTO が使っている
一人称での書き方は、わたしには魅力があるように思えます。この魅力は、そう
でない大部分の文書からは得難いものです。自分自身として話すことを恐れずに、
<quote> I </quote> を使い、体験談や自分の意見を書いてください。</para>

    <!--
    <para>
      If it hasn't become painfully obvious yet, the underlying principle
      of all these suggestions is simplicity. 
      Your readers are already struggling with new concepts, so don't
      make them struggle to understand your language.
      Remember the <acronym>KISS</acronym> principle: Keep It Simple, Stupid!
    </para>
    -->
<para>これ以上くどいと思うかたがいらっしゃるとは思いますが、これらすべての
提案の基調となっている原則は、シンプルであることです。読者はすでにあたらしく
登場する概念と日々格闘しているのですから、あなたの言葉が理解できずに格闘
するといったことにならないようにしてください。<acronym>KISS</acronym> の
原則を忘れないようお願いします: Keep It Simple, Stupid!
</para>

  </sect1>
  
  <sect1 id="sg-editing">
    <title><!--Editing and Proofing the Text-->テキストの推敲と校正</title>
    
    <!--
    <para>
      Once you've written the text of your HOWTO, it is time to polish      
      and refine it. Good editing can make the difference between a good
      HOWTO and a great one.
    </para>
    -->
<para>HOWTO の文章を書き終わったら、次は、それを推敲して磨きをかけます。
推敲の善し悪しで、まずまずの HOWTO か、すばらしい HOWTO かが決まります。
</para>
    
    <!--
    <para>
      One of the goals of editing is to remove extraneous material that
      has crept its way into your document.
      You should go through your HOWTO carefully, and ruthlessly
      delete anything that doesn't contribute to the reader's understanding
      of the subject matter. It is natural for writers to go off on tangents
      while in the process of writing. This is the time to correct that.
    </para>
    -->
<para>推敲の目的は、文書に忍び込んだ余計な事柄を削除することです。HOWTO を
注意深く読み返して、その主題についての読者の理解に役立たないものは、バッサリ
と削ってください。文章を書いているうちに脱線するのは、著者として自然なこと
です。今は、それを訂正するときです。</para>
    
    <!--
    <para>
      When editing and proofing your work, you must check for obvious 
      mistakes, 
      such as spelling errors and typos. 
      However, you should check for deeper, but
      less obvious errors as well, such as <quote>holes</quote> in the
      information. Make sure that the contents of every section match
      the title of that section precisely.
    </para>
    -->
<para>推敲と校正の際は、スペルミスや typo といった明らかなミスをチェック
しなくてはなりません。しかし、その際、もっと深くて、見つけにくい、
必要な情報の <quote>欠落</quote> も同時にチェックすべきです。セクションの
内容がそのセクションのタイトルと正確に合致しているかどうか確認してください。
</para>
    
    <!--
    <para>
      When you are completely satisfied with the quality and accuracy of
      your work, forward it to someone else for third-party proofing.
      You will be too close to the work to see fundamental flaws.
    </para>
    -->
<para>文書の質と正確さについて完全に満足のいくものができたら、次にそれを
誰かに渡して、第三者として校正してもらってください。自分では作品に近すぎて、
根本的な欠点を理解できないことがあるからです。</para>
    
    <!--
    <para>
      In a sense, editing is like code review in software development.
      Having a programmer review their own code doesn't make much sense,
      does it? Why does having a writer edit their own document make
      any more sense?
      So, recruit a friend, or write the
      ldp-discuss list to find a volunteer to proofread before submitting
      your HOWTO.
    </para>
    -->
<para>こうした校訂は、ある意味で、ソフトウェア開発のコード・レビューの
ようなものです。プログラマが自分たちで作ったコードをレビューしてもあまり意味
がないでしょう？ 作者が自分たちで作った文書を校訂しても、それ以上意味のある
結果を得られるでしょうか？ そうしたわけで、友人をリクルートするか、
ldp-discuss メーリングリストに投稿してボランティアを捜し、寄稿する前に 
HOWTO を校正するようにしてください。</para>

    <note>
      <!--
      <para>
        If you are writing in a language in which you are not fluent,
        I strongly recommend that you seek an editor who is. Technical
        documentation, more than any other type of writing, must use
        extremely precise grammar and vocabulary. Misuse of the language,
        no matter how understandable and unintended, makes your HOWTO
        less valuable.
      </para>
      -->
<para>もし自分では精通していない言語で文書を書いている場合は、その言語に
精通した校正者を捜すことを強くお薦めします。技術文書では、他のどんな
タイプの文書よりも、特段に正確な文法と語彙を使わなければなりません。
言葉の誤用は、それがどれほど致し方のない意図せざる誤用であったとしても、
あなたの HOWTO の価値を低下させてしまいます。</para>
    </note>

  </sect1>
  
  <sect1 id="sg-maintaining">
    <title><!--Maintaining Your HOWTO-->作成した HOWTO の管理</title>
    
    <!--
    <para>
      Just because your HOWTO has now been published doesn't mean your
      job is done. HOWTOs need regular maintenance, to make sure they
      are up to date, and to improve them in response to readers' ideas
      and suggestions. A HOWTO is a living, growing body of knowledge,
      not just a publish-and-forget-it static document.
    </para>
    -->
<para>作成した HOWTO 文書が公開されたからといって、仕事がすべて終わった
わけではありません。HOWTO の情報を更新し、読者のアイデアや提案に応えて 
HOWTO を確実に改善していくためには、定期的なメンテナンスが必要です。
HOWTO には、活発に成長する生きた知識が詰まっているので、公開してそれで
終わりという固定的なものではありません。</para>
    
    <!--
    <para>
      You put your email address in the HOWTO, and politely requested
      feedback from your readers, right? Once you are officially published,
      you will begin to receive notes with suggestions. Some will be
      very valuable; others will request personal assistance. You should
      feel free to decline personal assistance if you cannot spare the
      time. Writing a HOWTO for the LDP doesn't commit you to a lifetime
      of free support for anyone on the net. It is polite to refer
      questioners to another resource, if you can. And, if you see a
      pattern in the questions you receive, it might indicate a topic
      you should add to your HOWTO.
    </para>
    -->
<para>HOWTO に自分のメールアドレスを書いて、読者からのフィードバックを
丁寧にお願いしたでしょうか？ 一旦正式に公開されると、提案のメールを
いくつも受け取るようになります。そのなかにはとても貴重なものがありますが、
それ以外は個人的な問題の解決を求めるものだったりします。時間がなければ、
個人的な問題に応える必要は全くありません。LDP で HOWTO を書いたからといって、
ネット上のあらゆる人にフリーサポートを生涯続ける義務を負うわけではないから
です。ただ、もしできるなら、そうした人に別の情報源を教えてあげると、親切では
あります。また、受け取った質問のパターンが見えてくれば、HOWTO に追加すべき
トピックが分かるかもしれません。</para>
  </sect1>

  <sect1 id="sg-references">
    <title id="sg-references.title"><!--References-->リファレンス</title>
    
    <!--
    <para>
      There are many guides to writing style available online.
      Here is a brief list of some of the best:
    </para>
    -->
<para>文章の書き方に関する文献がオンライン上にもたくさんあります。
特にすぐれたもののいくつかを簡単に紹介します。</para>
    
    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.resort.com/~prime8/Orwell/patee.html">
          <citetitle>Politics and the English Language</citetitle></ulink>.
        </para>
      </listitem>

      <listitem>
        <para>
          <ulink url="http://bartleby.com/141"><citetitle>Elements of Style
          </citetitle></ulink>
        </para>
      </listitem>

      <listitem>
        <!--
        <para>
          FIXME: Please send the URL of your favorite resource on technical 
          writing.
        </para>
        -->
<para>FIXME: テクニカル・ライティングに関する良い文献がありましたら、
URL をお教えください。</para>
      </listitem>

    </itemizedlist>
    
  </sect1>
    
</chapter>
