Use if xrefs in topic based or minimalist writing; was, RE: an editing question

Subject: Use if xrefs in topic based or minimalist writing; was, RE: an editing question
From: "Porrello, Leonard" <lporrello -at- illumina -dot- com>
To: Monique Semp <monique -dot- semp -at- earthlink -dot- net>, Becca <becca -at- di -dot- org>, tech2wr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 17 Jun 2013 19:21:57 +0000

Are you eliminating all xrefs?

-----Original Message-----
From: techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Monique Semp
Sent: Monday, June 17, 2013 11:57 AM
To: Becca; tech2wr-l
Subject: Re: an editing question

> In cases like this, is it common to get the chapters helter-skelter
> and out of order? I'm finding it very difficult to edit the chapters
> out of context.

Yes, it's very common; such is the life of tech writers and editors. And for Agile environments, not only do you receive things out of order, you have to write them out of order as the software crawls to completion. Plus, in extreme minimalism and/or topic-based authoring environments, every topic is supposed to stand on its own, with no expectation that anyone is going to read anything "in order". (I'm still trying to break my habit of including xrefs everywhere.)

YMMV,
-Monique

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

You are currently subscribed to TECHWR-L as lporrello -at- illumina -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: RE: Robo vs Flare
Next by Author: RE: Use if xrefs in topic based or minimalist writing
Previous by Thread: Re: an editing question
Next by Thread: Re: Use if xrefs in topic based or minimalist writing


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

Sponsored Ads


Sponsored Ads