[TYPO3-about] Working as a developer instead of making documentation

[Steffen Müller]

Hi.

On 21.01.2013 12:09 Christian Woebbeking wrote:
> * And furthermore: Why do people prefer working as a developer instead of
> making documentation?
> 

My thesis:

* Developers are more used write code in programming language than
writing documentation in natural language. They have more
experience/routine in writing program code than natural language.
* Developers use IDE, which supports writing program code (e.g.
autocomplete). They don't have these tools for writing natural language.
* Code is functional and can be tested (works <-> does not work).
Natural language can't be tested (only proof-read).
* Documentation is rather abstract, while program code is concrete.
* You will rather find code snippets in the web than documentation
snippets.
* Developers work routine is shaped by customer projects demands. How
often did you hear this statement: "We don't need/pay for documentation".

last but not least:
* Writing code means solving problems <-> Writing documentation means
explaining problem solutions. Solving problems gives higher gratification.

-- 
cheers,
Steffen

TYPO3 Blog: http://www.t3node.com/
Twitter: @t3node - http://twitter.com/t3node