Ask HN: Any good guide which include best practices for library developers?

A famous guide to evaluate your APIs:

- https://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html

- https://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html

Josh Bloch did a good google tech talk on general aspects of API design.

https://www.youtube.com/watch?v=heh4OeB9A-c

One thing I can say which is probably a low hanging fruit. Error handling. Return errors in such a way that the application using the library can actually do something with it.

For documentation, this site has a good framework for organizing library docs: https://diataxis.fr/