The most pleasant to use libraries I’ve encountered are Sean Barret’s stb collection. He takes this a step further, and puts all the documentation in the same file as the code.
When you want a high level overview and example code, it’s at the top of the header. When you want detailed documentation on a specific function, it’s a ctrl+f away. It’s (close to) the minimum required effort to read the docs.
Yeah, we ended up doing this at Google too.
The most pleasant to use libraries I’ve encountered are Sean Barret’s stb collection. He takes this a step further, and puts all the documentation in the same file as the code.
When you want a high level overview and example code, it’s at the top of the header. When you want detailed documentation on a specific function, it’s a ctrl+f away. It’s (close to) the minimum required effort to read the docs.