TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

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

15 pointsby nerdyadventurerover 2 years ago
I am interested in use cases such as<p>- server-side libraries ex: sentry serverside clients<p>- front-end libraries ex: react-query<p>I am interested in aspects like API design, architectural decisions, dev tooling and etc.

4 comments

dyingkneepadover 2 years ago
A famous guide to evaluate your APIs:<p>- <a href="https:&#x2F;&#x2F;ozlabs.org&#x2F;~rusty&#x2F;index.cgi&#x2F;tech&#x2F;2008-03-30.html" rel="nofollow">https:&#x2F;&#x2F;ozlabs.org&#x2F;~rusty&#x2F;index.cgi&#x2F;tech&#x2F;2008-03-30.html</a><p>- <a href="https:&#x2F;&#x2F;ozlabs.org&#x2F;~rusty&#x2F;index.cgi&#x2F;tech&#x2F;2008-04-01.html" rel="nofollow">https:&#x2F;&#x2F;ozlabs.org&#x2F;~rusty&#x2F;index.cgi&#x2F;tech&#x2F;2008-04-01.html</a>
gte525uover 2 years ago
Josh Bloch did a good google tech talk on general aspects of API design.<p><a href="https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=heh4OeB9A-c" rel="nofollow">https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=heh4OeB9A-c</a>
codegeekover 2 years ago
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.
rjmillover 2 years ago
For documentation, this site has a good framework for organizing library docs: <a href="https:&#x2F;&#x2F;diataxis.fr&#x2F;" rel="nofollow">https:&#x2F;&#x2F;diataxis.fr&#x2F;</a>