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

136 lines
5.2 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: Style Guide (was Re: I'm a sucker) -->
<!--X-From-R13: Rnivq Zyblq <yybl0076Nerory.arg.nh> -->
<!--X-Date: Mon, 9 Oct 2000 00:31:58 &#45;0400 (EDT) -->
<!--X-Message-Id: 39E14CC4.869519E3@rebel.net.au -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: 39DD12BF.FE05CD21@rebel.net.au -->
<!--X-Reference: 39DD1C60.569B658C@mindspring.com -->
<!--X-Reference: kiwu2aqi1u1.fsf@blinky.bloomberg.com -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: Style Guide (was Re: I'm a sucker)</title>
<link rev="made" href="mailto:lloy0076@rebel.net.au">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg03972.html">Date Prev</a>][<a href="msg03974.html">Date Next</a>][<a href="msg03964.html">Thread Prev</a>][<a href="msg03992.html">Thread Next</a>][<a href="maillist.html#03973">Date Index</a>][<a href="threads.html#03973">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: Style Guide (was Re: I'm a sucker)</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: &quot;Harvey J. Stein&quot; &lt;<A HREF="mailto:hjstein@bfr.co.il">hjstein@bfr.co.il</A>&gt;</li>
<li><em>Subject</em>: Re: Style Guide (was Re: I'm a sucker)</li>
<li><em>From</em>: David Lloyd &lt;<A HREF="mailto:lloy0076@rebel.net.au">lloy0076@rebel.net.au</A>&gt;</li>
<li><em>Date</em>: Mon, 09 Oct 2000 14:12:44 +0930</li>
<li><em>Cc</em>: David Merrill &lt;<A HREF="mailto:dcmerrill@MINDSPRING.COM">dcmerrill@MINDSPRING.COM</A>&gt;, <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
<li><em>References</em>: &lt;<a href="msg03946.html">39DD12BF.FE05CD21@rebel.net.au</a>&gt; &lt;<a href="msg03948.html">39DD1C60.569B658C@mindspring.com</a>&gt; &lt;<a href="msg03964.html">kiwu2aqi1u1.fsf@blinky.bloomberg.com</a>&gt;</li>
<li><em>Resent-date</em>: Mon, 9 Oct 2000 00:31:58 -0400 (EDT)</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;CcGl5.A.KYF.5qU45@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>
<li><em>Sender</em>: <A HREF="mailto:lloy0076@rebel.net.au">lloy0076@rebel.net.au</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
Hi there!
&gt; Don't forget that the most important point of the LDP is to get
&gt; documentation. Any hurdles placed in the way will lead to less
&gt; documentation.
I agree, but some people may actually want some guidelines on how or
what they should write. It also helps the volunteers who change the
document into the final form...
&gt; It's one thing to have a Style Guide and another to
&gt; have a Howto Howto with a style section that starts with something
&gt; like &quot;If you're worrying about your writing style, we suggest
&gt; following these guidelines: ...&quot;. Remember - the authors are
&gt; volunteers contributing documentation. The LDP should make doing that
&gt; as easy as possible.
That's essentially what I was saying. It does help to remind people that
they are writing for an International audience and other such salient
things...
DL
[1]
To argue in hyperbole, if we are really worried about putting hurdles in
the way, then the HOWTO-HOWTO or Authoring Guide really shouldn't exist
at all...it should say submit documentation to: &lt;email address&gt; in
whatever format you want.
--
And so it was that later
As the miller told his tale
That a face that at first was ghostly
Turned a whiter shade of pale....
--
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="03946" href="msg03946.html">Style Guide (was Re: I'm a sucker)</a></strong>
<ul><li><em>From:</em> David Lloyd &lt;lloy0076@rebel.net.au&gt;</li></ul></li>
<li><strong><a name="03948" href="msg03948.html">Re: Style Guide (was Re: I'm a sucker)</a></strong>
<ul><li><em>From:</em> David Merrill &lt;dcmerrill@mindspring.com&gt;</li></ul></li>
<li><strong><a name="03964" href="msg03964.html">Re: Style Guide (was Re: I'm a sucker)</a></strong>
<ul><li><em>From:</em> hjstein@bfr.co.il (Harvey J. Stein)</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg03972.html">new_document</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg03974.html">hooking...</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg03964.html">Re: Style Guide (was Re: I'm a sucker)</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg03992.html">Making It Easy For New Authors (was Re: Style Guide)</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#03973"><strong>Date</strong></a></li>
<li><a href="threads.html#03973"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>