old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-discuss/msg04559.html

139 lines
5.1 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: documentation -->
<!--X-From-R13: "Uert Trethfba" <tsretNubbc.gvzbavhz.ftv.pbz> -->
<!--X-Date: Mon, 4 Dec 2000 09:31:23 &#45;0500 (EST) -->
<!--X-Message-Id: 10012040930.ZM11364@hoop.timonium.sgi.com -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: 002401c05ce3$5ae40b40$0c00000a@winows98 -->
<!--X-Reference: brian0029@bigpond.com -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: documentation</title>
<link rev="made" href="mailto:gferg@hoop.timonium.sgi.com">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg04558.html">Date Prev</a>][<a href="msg04560.html">Date Next</a>][<a href="msg04550.html">Thread Prev</a>][<a href="msg04553.html">Thread Next</a>][<a href="maillist.html#04559">Date Index</a>][<a href="threads.html#04559">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: documentation</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: &quot;Brian Stephenson&quot; &lt;<A HREF="mailto:brian0029@bigpond.com">brian0029@bigpond.com</A>&gt;, &lt;<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>&gt;, <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
<li><em>Subject</em>: Re: documentation</li>
<li><em>From</em>: &quot;Greg Ferguson&quot; &lt;<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>&gt;</li>
<li><em>Date</em>: Mon, 4 Dec 2000 09:30:36 -0500</li>
<li><em>In-reply-to</em>: &quot;Brian Stephenson&quot; &lt;brian0029@bigpond.com&gt; &quot;documentation&quot; (Dec 3, 2:41pm)</li>
<li><em>References</em>: &lt;<a href="msg04550.html">002401c05ce3$5ae40b40$0c00000a@winows98</a>&gt;</li>
<li><em>Resent-date</em>: Mon, 4 Dec 2000 09:31:23 -0500 (EST)</li>
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
<li><em>Resent-message-id</em>: &lt;SB9IiB.A.icE.wt6K6@murphy&gt;</li>
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
On Dec 3, 2:41pm, Brian Stephenson wrote:
&gt; Subject: documentation
&gt; Hi
&gt; I am thinking of writing a howto for the LinuxBIOS project,
&gt; I am currently obtaining and organising information for this,
&gt; but I am completely new when it comes to documentation,
&gt; I just started looking at the requirements on the web site and
&gt; hopefully should get started soon.
&gt; I envisage the first document to be a mini howto as it only
&gt; involves one type of hardware, with many more to come
&gt; later.
&gt;
&gt; any tips would be most welcome.
Start with the LDP Author Guide:
<A HREF="http://www.linuxdoc.org/LDP/LDP-Author-Guide/">http://www.linuxdoc.org/LDP/LDP-Author-Guide/</A>
In our &quot;author's resources&quot; area
<A HREF="http://www.linuxdoc.org/authors/index.html#resources">http://www.linuxdoc.org/authors/index.html#resources</A>
there are pointers to various helpful documents/books
including:
DocBook: The Definitive Guide, by Norman Walsh and Leonard Muellner
<A HREF="http://docbook.org/tdg/html/docbook.html">http://docbook.org/tdg/html/docbook.html</A>
Using DocBook HOWTO, by Jorge Godoy
<A HREF="http://www.ibiblio.org/godoy/using-docbook/using-docbook.html">http://www.ibiblio.org/godoy/using-docbook/using-docbook.html</A>
and there also pointers to downloadable template files for
HOWTOs (in DocBook and Linuxdoc SGML).
(I'll add your info to the &quot;docs in progress&quot; page).
Let me know if you have any questions.
r,
--
Greg Ferguson - s/w engr / mtlhd | gferg at sgi.com
SGI Tech Pubs - <A HREF="http://techpubs.sgi.com/">http://techpubs.sgi.com/</A> |
Linux Doc Project - <A HREF="http://www.linuxdoc.org/">http://www.linuxdoc.org/</A> | gferg at metalab.unc.edu
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. Trouble? Contact listmaster@lists.debian.org
</pre>
<!--X-Body-of-Message-End-->
<!--X-MsgBody-End-->
<!--X-Follow-Ups-->
<hr>
<!--X-Follow-Ups-End-->
<!--X-References-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="04550" href="msg04550.html">documentation</a></strong>
<ul><li><em>From:</em> &quot;Brian Stephenson&quot; &lt;brian0029@bigpond.com&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg04558.html">updated pricing</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg04560.html">DHCP</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg04550.html">documentation</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg04553.html">hi there</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#04559"><strong>Date</strong></a></li>
<li><a href="threads.html#04559"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>