Re: Real value (was implementing single-source) (Long)

Subject: Re: Real value (was implementing single-source) (Long)
From: Sandy Harris <sandy -at- storm -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 10 Nov 2000 14:56:46 -0500

Andrew Plato wrote:

> Furthermore, quick and efficient are rarely synonymous with quality. Quality
> documentation flows from the well-informed mind of a talented writer, not some
> huge documentation system. No XML based system can or will make documentation
> better if the people feeding information into it are morons. Morons at the helm
> of a powerful documentation system will just produce crap faster.
>
> Most XML-based implementations are outlandishly excessive. Writers who cannot
> handle complex information with their minds are not going to fair one iota
> better with some huge XML implementation.

Overall, I'm inclined to agree. Certainly clueless writers will not produce good
docs, whatever the system.

Methinks there's some hope, though, that XML will help. If the system emphasises
structure at the expense of font-twiddling, them it may force some of the partially
clued to think more about structure and organisation. This is a Good Thing(TM).
So is giving the clueful writer efficient ways to express document structure.

An XML system may also contain error checks that prevent some problems. e.g. I
recently mis-organised an HTML document. I wrote a section with an H1 and some
H3s but no H2s. One of my tools caught this and I fixed it. Given a well-written
DTD and the right tools, this sort of thing might become quite useful.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY.
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

Sponsored by SOLUTIONS, Conferences and Seminars for Communicators
Publications Management Clinic, TECH*COMM 2001 Conference, and more
http://www.SolutionsEvents.com or 800-448-4230

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Re: OT: Appalling English
Next by Author: Terminology quibble (was: Real value ...)
Previous by Thread: Re: Real value (was implementing single-source) (Long)
Next by Thread: Re: Real value (was implementing single-source) (Long)


What this post helpful? Share it with friends and colleagues:


Sponsored Ads