old-www/authors/template/intro.html

478 lines
9.0 KiB
HTML

<HTML
><HEAD
><TITLE
>Introduction</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
REL="HOME"
TITLE="HOWTO-template for Big HOWTOs"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="HOWTO-template for Big HOWTOs"
HREF="index.html"><LINK
REL="NEXT"
TITLE="Samples"
HREF="samples.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>HOWTO-template for Big HOWTOs</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="index.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="samples.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="INTRO"
>1. Introduction</A
></H1
><P
> For various reasons this brand new release is codenamed the
<I
CLASS="EMPHASIS"
>release</I
> release.
</P
><P
> New code names will appear as per industry standard
guidelines to emphasize the state-of-the-art-ness of this
document.
</P
><P
> This document was written when I read a feedback asking for a
template to fill in to make new HOWTOs. This template was
initially made by extracting the skeletal structure of the Multi
Disk HOWTO which is a rather large HOWTO. It then went through
extensive editing.
</P
><P
> Stating the background is a simple way to getting started
writing the intro.
</P
><P
> First of all we need a bit of legalese. Recent development
shows it is quite important.
</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="COPYRIGHT"
>1.1. Copyright Information</A
></H2
><P
> This document is copyrighted (c) 2000 Stein Gjoen and is
distributed under the terms of the Linux Documentation Project
(LDP) license, stated below. <I
CLASS="EMPHASIS"
>Replace with your name,
or supply a new license, when you use this skeleton for a new
HOWTO.</I
>
</P
><P
> Unless otherwise stated, Linux HOWTO documents are
copyrighted by their respective authors. Linux HOWTO documents may
be reproduced and distributed in whole or in part, in any medium
physical or electronic, as long as this copyright notice is
retained on all copies. Commercial redistribution is allowed and
encouraged; however, the author would like to be notified of any
such distributions.
</P
><P
> All translations, derivative works, or aggregate works
incorporating any Linux HOWTO documents must be covered under this
copyright notice. That is, you may not produce a derivative work
from a HOWTO and impose additional restrictions on its
distribution. Exceptions to these rules may be granted under
certain conditions; please contact the Linux HOWTO coordinator at
the address given below.
</P
><P
> In short, we wish to promote dissemination of this
information through as many channels as possible. However, we do
wish to retain copyright on the HOWTO documents, and would like to
be notified of any plans to redistribute the HOWTOs.
</P
><P
> If you have any questions, please contact
<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:linux-howto@metalab.unc.edu"
>linux-howto@metalab.unc.edu</A
>&#62;</TT
>
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="DISCLAIMER"
>1.2. Disclaimer</A
></H2
><P
> No liability for the contents of this documents can be accepted.
Use the concepts, examples and other content at your own risk.
As this is a new edition of this document, there may be errors
and inaccuracies, that may of course be damaging to your system.
Proceed with caution, and although this is highly unlikely,
the author(s) do not take any responsibility for that.
</P
><P
> All copyrights are held by their by their respective owners, unless
specifically noted otherwise. Use of a term in this document
should not be regarded as affecting the validity of any trademark
or service mark.
</P
><P
> Naming of particular products or brands should not be seen
as endorsements.
</P
><P
> You are strongly recommended to take a backup of your system
before major installation and backups at regular intervals.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="NEWVERSIONS"
>1.3. New Versions</A
></H2
><P
> This is where you make a summary of what is new. When a
HOWTO exceeds 20 pages it takes more than a casual read to find
the updates. This is where you help your readers with that,
alerting them to specific and important updates to the document.
</P
><P
> This is the initial release.
</P
><P
> Tell people where the document home page is so the very
newest release could be found in case of problems with the main
<A
HREF="http://www.linuxdoc.org/"
TARGET="_top"
>Linux Documentation
Project</A
> homepage.
</P
><P
> The following is a sample from the Multi Disk HOWTO:
</P
><P
> The latest version number of this document can be
gleaned from my plan entry if you
<A
HREF="http://www.cs.indiana.edu/finger/nox.nyx.net/sgjoen"
TARGET="_top"
> finger</A
> my Nyx account.
</P
><P
> <I
CLASS="EMPHASIS"
>If you have the capability, it would be nice to
make the HOWTO available in a number of formats.</I
>
</P
><P
> The newest version of this HOWTO will always be made available on
my website, in a variety of formats:
</P
><P
> <P
></P
><UL
><LI
><P
> <A
HREF="http://www.nyx.net/~sgjoen/disk.html"
TARGET="_top"
>HTML</A
>.
</P
></LI
><LI
><P
> <A
HREF="http://www.nyx.net/~sgjoen/disk.txt"
TARGET="_top"
>plain text</A
>.
</P
></LI
><LI
><P
> <A
HREF="http://www.nyx.net/~sgjoen/disk-US.ps.gz"
TARGET="_top"
>compressed
postscript (US letter format)</A
>.
</P
></LI
><LI
><P
> <A
HREF="http://www.nyx.net/~sgjoen/disk.sgml"
TARGET="_top"
>SGML source</A
>.
</P
></LI
></UL
>
</P
><P
> Note that paper sizes vary in the world, A4 and US letter differ
significantly. You might also wish to consider using the
<I
CLASS="EMPHASIS"
>universal format</I
> (8.27x11in; 210x279mm).
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CREDITS"
>1.4. Credits</A
></H2
><P
> <I
CLASS="EMPHASIS"
>It is always nice to acknowledge people who help you
with input; it is also regarded by many as important in the
Linux world new economy.</I
>
</P
><P
> In this version I have the pleasure of acknowledging:
</P
><P
> <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:name (at) site.org"
>name (at) site.org</A
>&#62;</TT
>
</P
><P
> <I
CLASS="EMPHASIS"
>Please scramble the addresses so email harvesters
cannot get addresses from your HOWTO and then spam people. That
has happened in the past.</I
>
</P
><P
> <I
CLASS="EMPHASIS"
>Somecompany</I
> is acknowledged for sending me
documentation on their gizmos as well as permission to quote from
the material. These quotes have been approved before appearing
here and will be clearly labeled.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="FEEDBACK"
>1.5. Feedback</A
></H2
><P
> Feedback is most certainly welcome for this document. Without
your submissions and input, this document wouldn't exist. Please
send your additions, comments and criticisms to the following
email address : <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:sgjoen@nyx.net"
>sgjoen@nyx.net</A
>&#62;</TT
>.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="TRANSLATIONS"
>1.6. Translations</A
></H2
><P
> Not everyone speaks English, pointers to translations are nice.
Also your translators tend to give very important inputs.
</P
><P
> <P
></P
><UL
><LI
><P
> <A
HREF="http://linuxdoc.org/"
TARGET="_top"
>German Translation</A
>
by <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:someone (at) somewhere.de"
>someone (at) somewhere.de</A
>&#62;</TT
>
</P
></LI
><LI
><P
> <A
HREF="http://linuxdoc.org/"
TARGET="_top"
>French Translation</A
>
by <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:someone (at) somewhere.fr"
>someone (at) somewhere.fr</A
>&#62;</TT
>
</P
></LI
><LI
><P
> <A
HREF="http://linuxdoc.org/"
TARGET="_top"
>Italian Translation</A
>
by <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:someone (at) somewhere.it"
>someone (at) somewhere.it</A
>&#62;</TT
>
</P
></LI
></UL
>
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="index.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="samples.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>HOWTO-template for Big HOWTOs</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Samples</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>