Re: Use if xrefs in topic based or minimalist writing
Are you eliminating all xrefs?
No -- just not using xrefs wantonly.
I'd say that's doing agile wrong. Docs are not code and writers arechickens, not pigs. Reasonable implementation means decoupling the
editorial workflow and timeline from programmers' task completion as
necessary for documentation to be written in a logical fashion.
Oh, I never said that I was participating in a "proper" agile process. I know full well that it's not supposed to be chaos, but in reality, it often is.
I don't have time at the moment for a real discussion about minimalism or Agile, but look forward to ongoing list conversations.
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
- RE: Use if xrefs in topic based or minimalist writing, Porrello, Leonard
Use if xrefs in topic based or minimalist writing; was, RE: an editing question: From: Porrello, Leonard
Previous by Author:
Re: an editing question
Next by Author: RE: Numbered versus unnumbered heads in very technical reference guides
Previous by Thread: Use if xrefs in topic based or minimalist writing; was, RE: an editing question
Next by Thread: RE: Use if xrefs in topic based or minimalist writing
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites