Frank wrote:
> I feel sorry for you if you really have not yet understood that proper, early 
> and complete documentation and comments ARE ONLY an investment in the code, 
> because they save time and efforts later on, which always pay back - mostly 
> multiple times. 

Perhaps you might want to explain to me the return on investment of the Orca 
documentation then? Zero users, zero return on investment. 

I feel annoyed if you talk in absolutes like that, because I know that there 
are lots of situations where creating documentation is a waste of effort. And I 
have also been bitten by lack of documentation. And I have even been in a 
situation where both happened at the same time, where a lot of effort was put 
in creating the wrong kind of documentation. Oh, and I even wrote a bit of 
documentation myself. 

I have been thought many things at university, and there were many more things 
I had to learn in industry. And from open source projects, which have other 
things to teach. 

Investing means making decisions. Fully documented non-working code has no 
value. Working code that no-one can use neither. 

Your current communication is manipulative: you try to put yourself in a 
dominant position by using absolutes, saying you feel sorry for me, and 
bragging about your experience. That annoys me. If you want to convince me, use 
arguments. 

Stephan

https://en.m.wikipedia.org/wiki/Nonviolent_Communication

Reply via email to