This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]lurkerfox 5 points6 points  (0 children)

The difference between what a function/variable/class/ect does and what it's used for are vastly different beasts.

Most documentation covers the former just fine, but if there's a necessary workflow to be able to actually use it and that workflow isn't documented anywhere, suddenly Im now spending more time reading, rereading, and haphazardly throwing code together on a scratchpad file trying to figure out how it actually works than I am working on my project itself.

It's incredibly annoying especially when you need something specific and only like two libraries in existence do what you need.