RE: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)

Subject: RE: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)
From: "Janoff, Steve" <Steve -dot- Janoff2 -at- Teradata -dot- com>
To: "Robert Lauriston" <robert -at- lauriston -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 6 Nov 2009 19:22:15 -0500

That's an encouraging notion.

It would help me if you could point me to two documents that are very
different and yet composed using both DITA and minimalist principles.

I know that's not an easy request, but there's no better way to prove
your point -- and I really hope you're right.

Thanks,

Steve

PS - If you can't do this, then that doesn't mean you're wrong; it would
just prevent me from having to wait to find such examples myself.


-----Original Message-----
From: techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Robert Lauriston
Sent: Friday, November 06, 2009 9:18 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48,
Issue 27)

DITA doesn't result in cookie-cutter docs. It's about as much of a
straitjacket as XML. It's a formalized abstraction of best practices,
adaptable to a wide variety of document outlines, and is highly
customizable and extensible.

On Thu, Nov 5, 2009 at 6:15 PM, Janoff, Steve
<Steve -dot- Janoff2 -at- teradata -dot- com> wrote:
> ... if it's in DITA and written from a minimalist perspective, then it

> no doubt is going to fall into the cookie-cutter mode of the standard.
> It will probably look like many other such documents. ...
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help and Manual 5: The all-in-one help authoring tool. Full support for
team authoring with multi-user editing - both directly and in
combination with VSS-compatible source control systems.
http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as Steve -dot- Janoff2 -at- teradata -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/steve.janoff2%40terad
ata.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.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat

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

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help and Manual 5: The all-in-one help authoring tool. Full support for
team authoring with multi-user editing - both directly and in combination
with VSS-compatible source control systems. 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.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27): From: Chris Despopoulos
RE: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27): From: Janoff, Steve
Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27): From: Chris Despopoulos
Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27): From: Janoff, Steve
Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27): From: Robert Lauriston

Previous by Author: Re: Doc Design and Conventions
Next by Author: RE: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)
Previous by Thread: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)
Next by Thread: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)


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

Sponsored Ads


Sponsored Ads