Re: Code comments as Documentation

Subject: Re: Code comments as Documentation
From: Leigh Price <price_leigh -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 29 Sep 2004 14:49:09 -0700 (PDT)


> You're only "lowly" if that's what you believe.

Wow! I'm really glad you took me to task on this. You
are right. I'm not lowly. None of us are! Technical
writers ROCK!!! I really don't think of myself or any
other TWs that way.

I was thinking more about the potential politics of
the situation when I wrote my response.

There's no system in place here like the PPs describe,
other than VSS. And thus, code belongs strictly to
developers and doc belongs to TWs. They don't want me
changing the code, and I don't want them changing the
doc.

> Please don't tell me that you don't do things
> because "something may
> go wrong".

Ok, I won't. But I will tell you that I try to pick my
battles. :)

Leigh

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

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



References:
Re: Code comments as Documentation: From: John Posada

Previous by Author: Re: Code comments as Documentation
Next by Author: Re: Code comments as Documentation
Previous by Thread: Re: Code comments as Documentation
Next by Thread: Re: Code comments as Documentation


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


Sponsored Ads