On 3/7/2021 2:41 AM, Thomas de Groot wrote:
> I have learned by experience that writing instructions for everybody's 
> use (or for a dedicated group like in a working environment) is one of 
> the most challenging things to do, especially if you intend them to be 
> 'clear', 'consistent', 'comprehensible'. It is a humbling experience 
> too, about your own limitations. More often than not I got people coming 
> to me telling me that my instructions 'didn't work', 'crashed the 
> system', 'were Russian to them', etc... I learned to integrate those 
> reactions into comprehensive updates. :-)
> 
> Btw, I am still 'digesting' but I'll come back to the topic.
> 

I enjoy writing documentation, wiki articles, tables and charts, etc.

I almost NEVER comment my code however.

Meh.

Post a reply to this message