Feeling like most programming documentation is bad because the people writing it don't actually understand what they're writing about
-
-
Replying to @benedictfritz
really? to which (family of) docs are you referring? my gripe is always: "incomplete/outdated" or "assumes I understand something I don't"
1 reply 0 retweets 0 likes -
Replying to @Phildo211 @benedictfritz
like, it took me a solid decade before I could make sense of man pages haha. just didn't understand unix well enough. w/ unity, I've found /
1 reply 0 retweets 0 likes -
Replying to @Phildo211 @benedictfritz
_multiple_ instances where the docs are just _wrong_- which is doubly bad because now there's a resistance/mistrust with every doc I read.
1 reply 0 retweets 1 like -
Replying to @Phildo211 @benedictfritz
but I always attribute their wrong-ness to "lack of process to ensure correctness" rather than "someone not knowing what they r talking abt"
1 reply 0 retweets 0 likes -
Replying to @Phildo211
I guess it's more "not knowing what they're talking about" in the sense that they don't understand how people will actually use the thing
1 reply 0 retweets 1 like -
Replying to @benedictfritz @Phildo211
It's describing the thing from the perspective of someone who knows how it's implemented, reminding them how it's implemented
1 reply 0 retweets 2 likes
Not from the perspective of "what are people doing with this?" and "what do they need to understand to get where they're going?"
-
-
-
Replying to @Phildo211 @benedictfritz
lol also true x10000 for opengl docs. woof.
1 reply 0 retweets 1 like - 2 more replies
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.