TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: XML - where's the beef? From:Darren Barefoot <Darren -dot- Barefoot -at- capeclear -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 30 May 2001 16:05:32 +0100
My two cents:
Despite XML's origins in publishing, I really don't see technical
communication or, in fact, human-readable material in general, as the
appealing feature of XML-based technologies. As we know, XML is basically a
meta-language used to create languages that describe content. Given its
simplicity and ubiquity, this is pretty big news for computers talking to
other computers. However, in practical terms, I don't really see a lot of
documentation departments implementing this technology anytime soon.
Let's be honest...how many people have the time to add an additional layer
of meaning to the content they generate? My team certainly doesn't. Sure, it
would be nifty to generate many formats (customized PDFs, HTML files, etc)
from XML documents using XSLT and the like, but the writer still needs to
tell the XML document which bits are <overview> or <installation procedure>
or whatever.
Currently any of the decent XML authoring and documentation management
systems are really expensive. I could see people with a really big document
store (governments, large corporations) benefiting from these tools, but the
start-up costs in terms of resources would probably be pretty enormous.
Unless they've been using SGML and have some nifty conversion tools,
converting a document archive would be pretty heinous.
As for browsers, what's wrong with IE? It seems to display XML just fine.
However, unless you're passing your XML documents to a computer (a Web
service, an XLST processor, whatever), your audience won't want to look at
plain old XML. Plain old XML looks like this:
It will have to be transformed into something readable (such as HTML) before
it's useful to the end user. So, I don't really think browser technology is
an issue.
I hate to be a purist, but may I recommend Notepad for making XML, at least
to start? This enables a deep understanding of the language.
Interestingly, I just spell-checked this email in Outlook. It returned "XML"
as a misspelled word. That's indicative of something, don't you think?
That's all I got. DB.
> -----Original Message-----
> From: KMcLauchlan -at- chrysalis-its -dot- com
<big snip>
> Who is using what to *make* XML?
> What *are* you making with it?
> And, what browser/reader do you expect your
> audience to use?
>
> Are those that DO work in XML simply using it
> as an intermediary step, that nobody ever actually
> sees? You haul your documents through further
> conversion, to make print or PDFs or HTML pages?
> Does XML get read/viewed and appreciated in its
> own right, anywhere? Where would that be?
> I don't hear people touting an "XML-reader"
> equivalent of Acrobat Reader.
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
Sponsored by Information Mapping, Inc., a professional services firm
specializing in Knowledge Management and e-content solutions. See http://www.infomap.com or 800-463-6627 for more about our solutions.
---
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.