RE: Writing structured content [recap]

Subject: RE: Writing structured content [recap]
From: "Chris Vickery" <cvickery -at- arenasolutions -dot- com>
To: "Richard Lewis" <tech44writer -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 22 Jun 2007 11:10:22 -0700

DITA is not an analysis tool. It's a set of XML elements and that's all.
You have to do the analysis, chunking, whatever, yourself. Gordon is
asking how to change writers' writing style. I don't think anyone
suggested DITA as the analysis tool.

It's nice to know that the first hit for DITA is no longer Dita Von
Teese though. Maybe she's less popular now she left Marilyn Manson.

Who ordered the cheesecake?

Chris

-----Original Message-----
From: techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Richard Lewis
Sent: Friday, June 22, 2007 10:45 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Writing structured content [recap]

Gordon asks:

..... I'm more interested in how best to
shift a docs team from writing chapters, to writing distinct chunks of
information.

Richard Lewis responds:

Creating loosely-coupled, highly cohesive (i.e., highly modular)
chunks of information is an analysis issue. A fancy word for chunking
is partitioning. Partitioning is also a big part of the definition of
analysis. What you are trying to identify is an analysis technique.
Not some technology-based solution. I googled DITA. The first
entry stated "an XML-based..." - that's all I needed to know. Ain't no
such thing as an XML based analysis tool.








---------------------------------
Pinpoint customers who are looking for what you sell.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats
or
printed documentation. Features include support for Windows Vista & 2007

Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as cvickery -at- arenasolutions -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/cvickery%40arenasolut
ions.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


References:
Re: Writing structured content [recap]: From: Troy Klukewich
Re: Writing structured content [recap]: From: Richard Lewis

Previous by Author: RE: Tech Writer and BA Title
Next by Author: RE: FRIDAY: Unlikely athletes?
Previous by Thread: Re: Writing structured content [recap]
Next by Thread: OT: FRIDAY: Unlikely athletes?


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


Sponsored Ads