179 lines
7.6 KiB
HTML
179 lines
7.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Cataloging LDP White Paper: Document Reorganization -->
|
|
<!--X-From-R13: Yriva Qhyyvf <xrivaphNbepv.pbz> -->
|
|
<!--X-Date: Sat, 14 Oct 2000 01:27:37 -0400 (EDT) -->
|
|
<!--X-Message-Id: 39E7EF0F.604F57B7@orci.com -->
|
|
<!--X-Content-Type: multipart/mixed -->
|
|
<!--X-Reference: 39E762AF.3F299FF7@orci.com -->
|
|
<!--X-Reference: 022001c03550$a75698e0$14fd1eac@ora.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Cataloging LDP White Paper: Document Reorganization</title>
|
|
<link rev="made" href="mailto:kevincu@orci.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg04075.html">Date Prev</a>][<a href="msg04077.html">Date Next</a>][<a href="msg04071.html">Thread Prev</a>][<a href="msg04073.html">Thread Next</a>][<a href="maillist.html#04076">Date Index</a>][<a href="threads.html#04076">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Cataloging LDP White Paper: Document Reorganization</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Andy Oram <<A HREF="mailto:andyo@oreilly.com">andyo@oreilly.com</A>></li>
|
|
<li><em>Subject</em>: Re: Cataloging LDP White Paper: Document Reorganization</li>
|
|
<li><em>From</em>: Kevin Cullis <<A HREF="mailto:kevincu@orci.com">kevincu@orci.com</A>></li>
|
|
<li><em>Date</em>: Fri, 13 Oct 2000 23:28:47 -0600</li>
|
|
<li><em>Cc</em>: LDP Discuss List <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>References</em>: <<a href="msg04069.html">39E762AF.3F299FF7@orci.com</a>> <<a href="msg04071.html">022001c03550$a75698e0$14fd1eac@ora.com</a>></li>
|
|
<li><em>Resent-date</em>: Sat, 14 Oct 2000 01:27:37 -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>: <-78JxB.A.laE.J9-55@murphy></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:kevin@mx2.viawest.net">kevin@mx2.viawest.net</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Andy Oram wrote:
|
|
>
|
|
> That's a well-thought-out summary; you've remembered a lot of things that
|
|
> technically sophisticated folks tend not to remember when they put together
|
|
> documentation. I responded particularly to the Basic/Backgrounder section.
|
|
> One note from my experience: I try to get the Key Concepts right (or as an
|
|
> editor, push authors to get it right) and find I rarely need a Key Terms
|
|
> section because people know the terms once they've finished Key Concepts.
|
|
> But it doesn't hurt to leave a placeholder for Key Terms because it may be
|
|
> useful in many documents.
|
|
>
|
|
> While it may not affect this classification endeavor, we have to remember
|
|
> that documents tend to grow both in size and in scope. They also spawn
|
|
> related documents, which can be added to the
|
|
> Related sections.
|
|
>
|
|
> Andy
|
|
>
|
|
> --
|
|
> To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
|
|
|
|
Andy,
|
|
|
|
Thanks so much for the compliment (is it good enough for a book
|
|
proposal? ;-) ). As one who has a Masters in Process Improvement, ALL
|
|
improvements are important, not matter HOW small. As a suit moving into
|
|
the propeller head arena, I find that the communications from the techie
|
|
world to the user's world tends to be lacking (mostly programmers don't
|
|
think it's important). Therefore, I'm taking up the cause!! ;-)
|
|
|
|
May I point out that "small ideas" should NOT be lost in the shadow of
|
|
every "Big Idea!" Let me explain. I worked for Coors at one time (yea,
|
|
the beer company, it was a temp project during my Masters program) and
|
|
it came down from on high that only projects which saved $300,000 or
|
|
more were to be considered. They have 3000 people working for them. Now
|
|
how long will it take to find that $300,000 savings? How much time will
|
|
be in looking for only those sized projects? Tons of hours and $$. Now
|
|
look at this number: how about 3,000 employees finding savings of $100
|
|
each!! Same dollar value, but EVERYONE is contributing!! How many
|
|
people would be working on the single $300,000 project and who would
|
|
take ownership? Fewer still.
|
|
|
|
Another example. Again, during my Masters I watched a Admin person
|
|
retyping (on WordPerfect 5.2, the text based word processor) about 50
|
|
keys to bring up a word processor template. I timed her typing and
|
|
WITHOUT mistakes, it took her about 30 seconds to bring up that
|
|
template. To most, that doesn't seem like something to bother with.
|
|
But when I asked her how many times she brought up that template, she
|
|
stated "about 30 times a day!" To some, again, that still doesn't seem
|
|
like much, until you multiple the 30 seconds times the 30 times she does
|
|
that and she spent 15 minutes a typing the same thing over and over!!!
|
|
When I finally showed her the macro capability, she was delighted that I
|
|
had saved her 15 minutes a day as well as her typing fingers.
|
|
Everything counts in my book. ;-)
|
|
|
|
A key concept is communication while pppd or TCP/IP are key terms.
|
|
However, TCP/IP is a key concept, but TCP and IP are key terms. So,
|
|
depends on the scope.
|
|
|
|
Documents grow because things get more complicated and as more is added
|
|
to the body of knowledge, things get parsed smaller and smaller and
|
|
details grow.
|
|
|
|
A programmer friend of mine agrees with my CODETO concept and Pete and
|
|
I'll will be working over the next few weeks to modify my concept into
|
|
reality. He has stated that my idea, once it's adopted by Linux
|
|
programmers, will revolutionize Linux development and would take little
|
|
time to implement by module code maintainters (he was the one who got me
|
|
involved with Linux in the first place).
|
|
|
|
Continuous Improvement is the name of the game!!
|
|
|
|
Thanks again Andy.
|
|
|
|
Kevin</pre>
|
|
<pre>
|
|
begin:vcard
|
|
n:Cullis;Kevin
|
|
tel;home:720-489-9283
|
|
x-mozilla-html:FALSE
|
|
adr:;;8285 S Poplar Way #202;Englewood;CO;80112;USA
|
|
version:2.1
|
|
email;internet:kevincu@orci.com
|
|
x-mozilla-cpt:;0
|
|
fn:Kevin Cullis
|
|
end:vcard
|
|
</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="04069" href="msg04069.html">Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
<ul><li><em>From:</em> Kevin Cullis <kevincu@orci.com></li></ul></li>
|
|
<li><strong><a name="04071" href="msg04071.html">Re: Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
<ul><li><em>From:</em> "Andy Oram" <andyo@oreilly.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg04075.html">Mailing list page at ibiblio is broke</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg04077.html">Feedback</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg04071.html">Re: Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg04073.html">Re: Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#04076"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#04076"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|