Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
viking817427yWe don't do documentation.
Support is responsible for creating user documentation. We only document our solution - architecture and choices. How to use the system is the UX + support's responsibility, and should be clarified in feature requests that we implement.
I would never write a document on how to use what I coded. That responsibility belongs to the requester of the system/feature. -
i3dmax17yThat was all what I was doing in the last few days for a couple of features I implemented month ago. :P
-
some-one3777yI join the documentation haters club. I used to flame over applications that do not have good documentation but then I have changed as of now and have come to a mutual understanding of the pain it takes to create/maintain good docs.
-
i3dmax17y@kilstag
I think that creating them isn't the hardest thing but maintaining them as up-to-date is truly challenge. Mainly probably because of the fact that code maintenance usually takes a long course over time horizon, and second, most of docs maintained separately from the code, even they are just comments right above the code, no updating it usually wouldn't cause compiling failure. Overtime, things sure drift with no doubt. There are people believe that "documentation is evil."
!rant
Is it just me or programmers do suck at documentation?
undefined
fuck off so down voters