DEV Community

Discussion on: Big Signs That Your Documentation Stinks.

Collapse
 
aggieben profile image
Ben Collins

Nice post, Tim! One thing I might add; you can also tell your documentation stinks if your users are actually telling you so :-)

Collapse
 
tinkertim profile image
Tim Post

Users can be trusted, but other devs ... not as much :) We have a sort of obligation when it comes to our users (and this dynamic changes a bit when your users are also devs, e.g. you maintain a library) - but in general, internally, people are reticent to talk about the elephant in the room, or don't really notice it, at least in my experience.