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.
--- John Posada <JPosada -at- book -dot- com> wrote:
>
> > That said, I do consult with management and/or the team about
> > documentation issues such as the one you bring up and try to
> > reach a consensus on what or how we're going
>
> I've had NO instruction on how they want it. I came from vacation, my boss
> sat down and said "Go document XXX starting next Monday".
>
> Q: What do you want? A: Everything
> Q: How do you want it? A: The CTO liked what you did with X, give him one
> like you did for that system.
> Q: When do you want it? A: When you're done.
First thought that comes to mind is, "Okay, we do it warts and all. That will tell
them what needs cleaned up, repainted, fixed, etc."
Second thought is to go back, stick my head in the door, and ask, "So you want the
system as is, right? Even if I find things that need to be cleaned up." That will
either start a two minute dialog about what your concerns are, or the answer will
be, "Yes, that's what we want."
John, I suspect you can play it either way, because either way it sounds like
they'll want to know what they've got, maybe for the first time. It sounds like FUN!
---
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.
