<!ENTITY % globalent SYSTEM "../../libs/global.ent">
%globalent;
<!ENTITY % cdo-C SYSTEM "../../libs/cdo-C.ent">
%cdo-C;
<!ENTITY % xinclude SYSTEM "../../libs/xinclude.mod">
%xinclude;
<!ENTITY language "en">
<!ENTITY ubuntu '<phrase>Ubuntu</phrase>'>
]>
<preface id="preface" status="complete">
<title>About This Guide</title>
<sect1 id="conventions" status="complete">
<title>Conventions</title>
<para>
<emphasis role="bold">The following notes will be used
throughout the book:
</emphasis>
</para>
<note>
<para>A note presents interesting, sometimes technical, pieces
of information related to the surrounding discussion.
</para>
</note>
<tip>
<para>A tip offers advice or an easier way of doing
something.
</para>
</tip>
<caution>
<para>A caution alerts the reader to potential problems and
helps avoid them.
</para>
<!-- Direct referencing in a non-instructional context is bad. -->
</caution>
<warning>
<para>A warning advises the reader of a hazard that
may arise in a given scenario.
</para>
</warning>
<para>
<emphasis role="bold">Cross-reference conventions for print will
be displayed as follows:
</emphasis>
</para>
<itemizedlist>
<listitem>
<para>Links to other documents or websites will look like <ulink url="http://www.ubuntu.com">this</ulink>.
</para>
</listitem>
</itemizedlist>
<note>
<para>PDF, HTML, and XHTML versions of this document will use
hyperlinks to handle cross-referencing.
</para>
</note>
<para>
<emphasis role="bold">Type conventions will be displayed as
follows:
</emphasis>
</para>
<itemizedlist>
<listitem>
<para>File names or paths to directories will be shown in
<filename>monospace</filename>.
</para>
</listitem>
<listitem>
<para>
Commands that you type at a <application>Terminal</application>
command prompt will
be shown as:
</para>
<para>
<!-- NOTE: the spaces before </screen> are significant, and will be in the html output. -->
<screen>command to type </screen>
</para>
</listitem>
<listitem>
<para>Options that you click, select, or choose in a user
interface will be shown in
<filename>monospace</filename> type.
</para>
</listitem>
</itemizedlist>
<para>
<emphasis role="bold">Menu selections, mouse actions, and
keyboard short-cuts:
</emphasis>
</para>
<itemizedlist>
<listitem>
<para>A sequence of menu selections will be displayed as
follows: <menuchoice>
<guimenu>
<accel>F</accel>ile
</guimenu>
<guimenuitem>
<accel>O</accel>pen
</guimenuitem>
</menuchoice>
</para>
</listitem>
<listitem>
<para>Mouse actions shall assume a right-handed mouse
configuration. The terms <quote><mousebutton>click</mousebutton></quote>
and <quote><mousebutton>double-click</mousebutton></quote>
refer to using the left mouse button. The term <quote><mousebutton>right-click</mousebutton></quote>
refers to using the right mouse button. The
term <quote><mousebutton>middle-click</mousebutton></quote>
refers to using the middle mouse button,
pressing down on the scroll wheel, or pressing both the
left and right buttons simultaneously, based on the
design of your mouse.
</para>
</listitem>
<listitem>
<para>Keyboard shortcut combinations will be displayed as
follows: <keycombo>
<keycap>Ctrl</keycap>
<keycap>N</keycap>
</keycombo>
.Where the conventions for
<quote>Control</quote>, <quote>Shift,</quote> and
<quote>Alternate</quote> keys will be
<keycap>Ctrl</keycap>, <keycap>Shift</keycap>, and
<keycap>Alt</keycap>, respectively, and shall mean
the first key is to be held down while pressing the
second key.
</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="sect-contributing" status="complete">
<title>Contributing and Feedback</title>
<para>This book is developed by the <ulink url="&ubuntu-doc-team;">Ubuntu Documentation Team</ulink>. <emphasis>You</emphasis> can contribute to this document by sending ideas or comments to the Ubuntu Documentation Team mailing list. Information about the team, its mailing lists, projects, etc. can be found on the <ulink url="&ubuntu-doc-team;">Ubuntu Documentation Team Website</ulink>.
</para>
<para>If you see a problem with this document, or would like to make a suggestion, you can simply file a bug report at the <ulink url="&ubuntu-doc-bugs;">Ubuntu Bugtracker</ulink>. Your help is vital to the success of our documentation!</para>
