3 ms·
Ask HN: Any good guide which include best practices for library developers?
I am interested in use cases such as
- server-side libraries ex: sentry serverside clients
- front-end libraries ex: react-query
I am interested in aspects like API design, architectural decisions, dev tooling and etc.
- rjmill 4y agoFor documentation, this site has a good framework for organizing library docs: https://diataxis.fr/ https://diataxis.fr/
- dyingkneepad 4y agoA 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-03-30.html - https://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html https://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html
- gte525u 4y agoJosh Bloch did a good google tech talk on general aspects of API design. https://www.youtube.com/watch?v=heh4OeB9A-c https://www.youtube.com/watch?v=heh4OeB9A-c
- codegeek 4y agoOne 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.