Right. My take: "The library defines and exposes a small, simple, orthogonal core, that it uses to define the library functions."
-
-
This again refers to implementation. Could we spot a good/bad API without looking at its implementation?
1 reply 0 retweets 0 likes -
John's criteria isn't about just library API, it's about the library as a whole.
1 reply 0 retweets 0 likes -
Then could we tell a good library without looking at its implementation?
2 replies 0 retweets 0 likes -
Replying to @tomas_mikula @dwijnand and
Definitely no, I know tons of great libraries without any documentation... Just look at what Kmett is producing.
1 reply 0 retweets 1 like -
Replying to @aloiscochard @dwijnand and
Don't limit yourself to judging just by documentation. You can make a judgment based on the API and observable behavior.
1 reply 0 retweets 2 likes -
Replying to @tomas_mikula @dwijnand and
Had an interesting discussion with
@dibblego lately about writing a tool to automate this by analyzing sources.2 replies 0 retweets 1 like -
Replying to @aloiscochard @dwijnand and
I accept John's points 1. and 3. as self-evident. From a user's perspective, why should I care about 2.? Probably because it manifests as something I care about. What is that something and what's the causal link from orthogonality to that something.
1 reply 0 retweets 1 like -
Replying to @tomas_mikula @aloiscochard and
What if a function says, "this is a really nice and friendly function!" and then you look at the type and it looks hunky dory? Then bam, it goes into production and calls List#head Now you have a clusterfuck on your hands.
1 reply 0 retweets 0 likes -
Replying to @dibblego @aloiscochard and
This is covered by John's point 1.
1 reply 0 retweets 0 likes
I agree, but how do you measure it? Can it be called with null? Are you sure?
-
-
-
Replying to @tomas_mikula @aloiscochard and
Yes, but it's the pressing concern!
0 replies 0 retweets 1 like
End of conversation
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.