[OT] I am a developer and I hate documentation

karabuta via Digitalmars-d digitalmars-d at puremagic.com
Thu Aug 18 17:11:13 PDT 2016


On Thursday, 18 August 2016 at 08:40:23 UTC, Kagamin wrote:
> Article: 
> https://dzone.com/articles/why-developers-write-horrible-documentation-and-ho
> Also: 
> https://www.reddit.com/r/programming/comments/4y6pws/why_video_documentation_isnt_the_answer/

Ha ha ha! I read the article :) What sort of thinking went into 
writing this article?

Videos as documentation? So when you want to understand a single 
function, you just search for that section in the video which a 
bet will take more time. If you cannot write well (with all the 
corrections you can make when writing), how can you speak well in 
one shot.

So the question is, "Are programmers good verbal communicators 
than writers or vice versa"?

>> "Damian Wolf is an tech enthusiast and marketing professional. 
>> He loves to write about cloud technology, knowledge management 
>> and business performance.".
Mhmm, that's why.

>> Developers Don't Need Documentation
....
>> Video documentation is the answer.
This article is dangerous


More information about the Digitalmars-d mailing list