186 lines
7.0 KiB
HTML
186 lines
7.0 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: ODE - requirement for Editors -->
|
|
<!--X-From-R13: [negva Iurryre <zjurryreNfgnegrkg.pb.hx> -->
|
|
<!--X-Date: Mon, 10 Jan 2000 11:48:31 -0500 (EST) -->
|
|
<!--X-Message-Id: mwheeler-1000110142353.A017660@startext.demon.co.uk -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>ODE - requirement for Editors</title>
|
|
<link rev="made" href="mailto:mwheeler@startext.co.uk">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00995.html">Date Prev</a>][<a href="msg00986.html">Date Next</a>][<a href="msg01007.html">Thread Prev</a>][<a href="msg00985.html">Thread Next</a>][<a href="maillist.html#00989">Date Index</a>][<a href="threads.html#00989">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>ODE - requirement for Editors</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: ODE - requirement for Editors </li>
|
|
<li><em>From</em>: Martin Wheeler <<A HREF="mailto:mwheeler@startext.co.uk">mwheeler@startext.co.uk</A>></li>
|
|
<li><em>Date</em>: Mon, 10 Jan 2000 14:23:53 +0000 (GMT)</li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 10 Jan 2000 16:27:55 -0000</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>: <f5G_8D.A.9OG.Jige4@murphy></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>
|
|
|
|
|
|
--- Forwarded message from mwheeler on Mon, 10 Jan 2000 13:50:18 +0000 ---
|
|
|>From mwheeler Mon Jan 10 13:50:18 2000
|
|
Date: Mon, 10 Jan 2000 13:50:18 +0000
|
|
From: "Martin S. WHEELER" <mwheeler>
|
|
To: kim@dfusion.com.au
|
|
Subject: ODE - requirement for Editors
|
|
Message-ID: <20000110135018.A7421@startext.demon.co.uk>
|
|
Mime-Version: 1.0
|
|
Content-Type: text/plain; charset=us-ascii
|
|
User-Agent: Mutt/1.0i
|
|
Status: RO
|
|
Content-Length: 3154
|
|
Lines: 69
|
|
|
|
|
|
Kim __
|
|
|
|
I'm CCing this to ldp-discuss@lists.debian.org, and hoping that by some
|
|
mixture of magic and osmosis it will eventually end up in the in-trays of
|
|
interested readers of:
|
|
|
|
ldp-discuss@lists.debian.org
|
|
ldp-discuss@lists.linuxdoc.org
|
|
debian-doc@lists.debian.org
|
|
oswg-discuss@oswg.org
|
|
ldp-meta@franklin.oit.unc.edu
|
|
osrt@metalab.unc.edu
|
|
linuxkb-discuss@seul.org
|
|
gnome-doc-list@gnome.org
|
|
|
|
as I fear that cross-posting to all would be counter-productive at the moment.
|
|
But I have no idea how to hit all interested parties in one go.
|
|
Anyone offered to host ode-discuss@<wherever> yet?
|
|
[Debian? OSWG? Any offers anyone? Haven't the resources myself or would
|
|
offer.]
|
|
|
|
One point I have not seen discussed (or even mentioned) so far is the
|
|
inevitable necessity of having a team of editors involved in this initiative.
|
|
(All writers can benefit from working with a good editor -- I'm a writer; I
|
|
know.)
|
|
Not only to correct the typos, orthographic errors, dubious grammar and
|
|
semantic ambiguities any writer eventually becomes blind to, but -- far more
|
|
essentially -- to ensure that coherent form and structure are maintained and
|
|
understood by all members of a hugely disparate team, usually working in
|
|
(almost) total isolation from one another.
|
|
|
|
It's a QA control no serious writing project can afford to be without --
|
|
when properly applied, the benefits are a massive impact on reader perception
|
|
of professional credibility. (Which, I believe, was your concern in the first
|
|
place in calling for greater co-ordination).
|
|
As a group, we would be foolish to ignore this.
|
|
|
|
In this particular instance, assigning an (SGML-savvy) editor to each and every
|
|
document in the repository would, I believe, solve a great many problems
|
|
(while causing a few others, I have no doubt). I'm perfectly prepared to take
|
|
on this type of contribution to the initiative; any other takers care to join
|
|
me in an editing team?
|
|
|
|
(Retires gracefully under a hail of rocks, to shouts of: "Get off!/Texinfo
|
|
rules!" etc. etc. etc.)
|
|
|
|
To make myself perfectly clear -- I see the writer's job as producing clear,
|
|
unambiguous authoritative text for local document purposes; I see the
|
|
collaborating editor's job as helping the writer ensure that that text
|
|
conforms to the overall structural needs of the [global] documentation
|
|
project. (SGML-based or otherwise.)
|
|
|
|
Obviously, if the writer were able to mark up text appropriately, this would
|
|
be a bonus; but I feel we should make provision for coping with cases where
|
|
this is either not the case, or where legacy texts require translation.
|
|
A single editor could probably quite easily cope with marking up and
|
|
maintaining a number of different documents.
|
|
|
|
I'm also assuming that we can agree on a single markup format for all master
|
|
documents -- my own suggestion would be SGML [docbook DTD], as being the most
|
|
appropriate for the purposes of editing / publishing; electronic or
|
|
conventional.
|
|
|
|
Thoughts, anyone?
|
|
|
|
Martin
|
|
--
|
|
Martin Wheeler - StarTEXT - Glastonbury - BA6 9PH - England
|
|
mwheeler@startext.co.uk <A HREF="http://www.startext.co.uk/">http://www.startext.co.uk/</A>
|
|
|
|
|
|
--
|
|
Martin Wheeler - StarTEXT - Glastonbury - BA6 9PH - England
|
|
mwheeler@startext.co.uk <A HREF="http://www.startext.co.uk/">http://www.startext.co.uk/</A>
|
|
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
with a subject of "unsubscribe". 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="00985" href="msg00985.html">Re: ODE - requirement for Editors</a></strong>
|
|
<ul><li><em>From:</em> "der.hans" <ldp-discuss@LuftHans.com></li></ul></li>
|
|
<li><strong><a name="00978" href="msg00978.html">Re: ODE - requirement for Editors</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00995.html">Re: Open Document Environment (ODE)</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00986.html">HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg01007.html">HOWTO processing (Tim ???)</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00985.html">Re: ODE - requirement for Editors</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00989"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00989"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|