[Info-vax] Documentation, was: Re: Listeners in VMS Basic

[Simon Clubley]

On 2021-07-12, Dave Froble <davef at tsoft-inc.com> wrote:
>
> The key issue is, when a support person has to look at, or modify some 
> code, how easily he/she understands what is being done.  That influences 
> productivity.
>
> Ok, I lied about firing someone.  What I did was transfer him from 
> development to support, and, strangely, that improved his opinion about 
> comments.
>

I have never understood why it is considered acceptable in some quarters
to not bother writing documentation describing and documenting your code
and any design decisions you have taken.

Other professions have strong rules about documenting work (and rightly
so) so I don't see why software development should be any different.

Simon.

-- 
Simon Clubley, clubley at remove_me.eisner.decus.org-Earth.UFP
Walking destinations on a map are further away than they appear.