RE: Do you spellcheck Code Comments

["Matt Horn" <mhorn -at- macromedia -dot- com>]

> In the document, would you correct the spelling of "Exectute" 
> or would you send a note to the developer. wait for him to 
> fix it, and if he does, then make the change in the doc?.

I guess it depends on how often you expect to import the code comments.
Will there be Alpha, Beta 1, Beta 2, etc drafts, or is this a one time
shot? If it's the latter, then fix it in Frame and move on.

Maybe what you're really asking is how do you bug an engineer about
something so insignificant? You must know that what you see as a minor
typo might mean a whole check-out/check-in/recompile for them. 

I guess I would try and collect a bunch of spelling errors at once and
then pass the corrections to a manager who can then assign the task of
fixing them to a single engineer. It couldn't hurt if you ask a few
questions about the class files you're looking at, too, to show that
you're more than just a spellchecker.

$.02

Matthew Horn
Sr. Technical Writer
< m a c r o m e d i a > 


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

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
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.