Track examples of strong API design

[aturon]

We should provide a set of real-world APIs held in high esteem, and eventually do write-ups on what makes them so great.

[aturon]

Thread that inspired this: https://www.reddit.com/r/rust/comments/83oo29/what_are_the_most_welldesigned_rust_apis/

[KodrAus]

This sounds a bit like @dtolnay's idea for digging in to the API and design decisions behind some significant libraries. I think this is a great idea 👍 It should be a nice complement to the minutiae of the API Guidelines and another point of discoverability.

Maybe we could check in with the domain working groups and see what APIs their domains hold in high esteem?

[tomaka]

Thread that inspired this: https://www.reddit.com/r/rust/comments/83oo29/what_are_the_most_welldesigned_rust_apis/

To me the conclusion of this reddit post, with the exception if serde, is that people like functional programming.

[KodrAus]

@tomaka Yeh, I think when we take well-designed outside of a specific domain it's probably bound to end up being really broad. I suppose it's a balancing act between discussing APIs within a context that's so specific that it'll never be applicable to anyone and one that's so broad that its lessons are all caveats, or too subjective.