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
-
Oh yes.
Nothing is as frustrating as piecing together code from obsolete SO answers because the "documentation" consists of one trivial example per major feature and a bit of minimal explanation here and there. -
WRITE FUCKING DOCS! Can we just simply start with that? We can worry about making them PROPER later.
And "docs" very much includes commenting your fucking code! The next asshat that says their code is "self-documenting" can fuck a rusty spike. Code can be well-written or poorly-written but it's never truly self-documenting. It STILL needs (proper) commenting regardless.
WRITE YOUR FUCKING DOCS PROPERLY!!!
rant