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

161 lines
6.1 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: DocBook Walkthrough? -->
<!--X-From-R13: cnp1Ngvnp.arg -->
<!--X-Date: Mon, 22 May 2000 18:49:50 &#45;0400 (EDT) -->
<!--X-Message-Id: 3929B8A3.CDFC623A@tiac.net -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: Pine.LNX.4.21.0005211926090.1295&#45;100000@gw&#45;int.LuftHans.com -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: DocBook Walkthrough?</title>
<link rev="made" href="mailto:pac1@tiac.net">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg02500.html">Date Prev</a>][<a href="msg02502.html">Date Next</a>][<a href="msg02490.html">Thread Prev</a>][<a href="msg02507.html">Thread Next</a>][<a href="maillist.html#02501">Date Index</a>][<a href="threads.html#02501">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: DocBook Walkthrough?</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: &quot;der.hans&quot; &lt;<A HREF="mailto:ldp-discuss@LuftHans.com">ldp-discuss@LuftHans.com</A>&gt;, &quot;<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>&quot; &lt;<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>&gt;</li>
<li><em>Subject</em>: Re: DocBook Walkthrough?</li>
<li><em>From</em>: <A HREF="mailto:pac1@tiac.net">pac1@tiac.net</A></li>
<li><em>Date</em>: Mon, 22 May 2000 18:45:55 -0400</li>
<li><em>References</em>: &lt;<a href="msg02490.html">Pine.LNX.4.21.0005211926090.1295-100000@gw-int.LuftHans.com</a>&gt;</li>
<li><em>Resent-date</em>: Mon, 22 May 2000 18:49:50 -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;ne1pH.A.nrC.BmbK5@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>: pac1</li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
&quot;der.hans&quot; wrote:
&gt;
&gt; &gt; There are 13 kinds of tasks I've found so far.
&gt; &lt;snip&gt;4. Hardware administration
&gt; &gt; 5. User Administration and Security
&gt;
&gt; I see these as two different topics. Another topic of the same vein that
&gt; isn't covered is system administration. I'm glad you partitioned hardware
&gt; administration off as it's own major topic :).
&gt; &lt;snip&gt;
&gt; While user and system administration can be combined they can
&gt; also be very distinct. User admin is more for workstation (e.g. desktop)
&gt; support and shell accounts. I set system administration as being more
&gt; backend stuff, e.g. server and networking administration.
&gt; &lt;snip&gt;
&gt; Security, however, is definitely its own topic
How about
4. System Administration - Hardware
5. System Administration - Servers and Network
6. System Adminsitration - User
7. System Administration - Security
Items 6-13 renumbered 8- 15
&gt; Good work with the classifications. I actually think this type of thing
&gt; might greatly help us with organization of materials and with writing for
&gt; the correct audiences.
I'm hoping that it will. Much of the discussion in this thread seems to be related
to tools for producing documentation. I think that too much focus on the tools and
the resulting document structure can lead one to produce documentation that is
difficult for the un-initiated to use.
&gt; &gt; There are 6 levels of expertise related to things a Linux person may try to do.
&gt;
&gt; Have you looked at any of the certification projects?
Not with documentation in mind, but the parts of the tracks are similar arent they.
What I had in mind with these levels is that each of us has many competencies, each
with its own level of expertise. Any given person may be an &quot;expert in stucco&quot;, and
at the same time know nothing at all about being an &quot;outlaw in Peru&quot;* If one were
to keep track, the results would paint a finer grained picture of an individual than
a certification. The classifications would be meant for an individual to classify
themselves by estimation rather than for someone else to certify them. A user could
use the classification to focus their initial &quot;view&quot; of documentation appropriate to
their current level of expertise on a topic by topic.
There's an open source project lurking in here somewhere. Interested parties should
contact me.
-Pat
* for the source of these quotes see
<A HREF="http://www.ccs.neu.edu/home/maddog/stuff/essay.html">http://www.ccs.neu.edu/home/maddog/stuff/essay.html</A> or search the we for either
phrase in quotes.
--
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>
<ul><li><strong>Follow-Ups</strong>:
<ul>
<li><strong><a name="02507" href="msg02507.html">Re: DocBook Walkthrough?</a></strong>
<ul><li><em>From:</em> &quot;der.hans&quot; &lt;ldp-discuss@LuftHans.com&gt;</li></ul></li>
</ul></li></ul>
<!--X-Follow-Ups-End-->
<!--X-References-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="02490" href="msg02490.html">Re: DocBook Walkthrough?</a></strong>
<ul><li><em>From:</em> &quot;der.hans&quot; &lt;ldp-discuss@LuftHans.com&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg02500.html">Arranging a Usenix documentation BoF</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg02502.html">Re: Missing Authors</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg02490.html">Re: DocBook Walkthrough?</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg02507.html">Re: DocBook Walkthrough?</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#02501"><strong>Date</strong></a></li>
<li><a href="threads.html#02501"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>