Re: The Light of Day

[Rowena Hart <rhart -at- xcert -dot- com>]

Dianne's posting reminded me of problems
caused by the use/misuse of the following:

- "hidden" HTML comments
- revision control logs
- bug tracking logs

I'm guilty of putting "reminder to self"
HTML comments in documents that are later
released to customers. Although it can be
useful to include comments in your HTML
code, it can be misused.

I've also heard about and seen several
instances of poorly worded revision control
and bug tracking logs (e.g. "Fixed item that
would have worked if so-and-so did their
job properly") that the author probably didn't
realize would be read by testers, developers, 
project managers, and sometimes customers.
Revision control logs and bug tracking logs
are usually part of the company's permanent
development record/history.

Rowena

Dianne Blake wrote:

> I recently worked at a place where one of the instructors constantly
> added notes to himself in his PowerPoint presentations. That isn't too
> bad, but he wouldn't go back and look at his work before sending it off
> to the printers, or delivering the materials to other instructors to
> teach.
> 
> I can't tell you how many times I would review his work (before teaching
> it, but after he sent it to the printer) and find phrases like:
> 
>    *  Yadda, yadda, yadda
>    *  Ask so-and-so about this
>    *  ????
>    *  What does this mean?
<snip>