|
|
Op 13/05/2021 om 06:27 schreef Mike Horvath:
> 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.
>
Oh, I certainly agree with that! However, it does not come easy and
needs a lot of corrections and rewriting before it is even basically
acceptable to me. An extra challenge is to do it in English which is not
my native language (which does not make writing in my /native/ languages
any easier though).
> I almost NEVER comment my code however.
>
I almost ALWAYS do. ;-)
--
Thomas
Post a reply to this message
|
|