Skip to content

Instantly share code, notes, and snippets.

@fjsj
Last active May 6, 2023 13:18
Show Gist options
  • Star 2 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save fjsj/f91bf0e4e326554672c10cb152a6fda4 to your computer and use it in GitHub Desktop.
Save fjsj/f91bf0e4e326554672c10cb152a6fda4 to your computer and use it in GitHub Desktop.
References for How to make a good library API - PyCon 2017: http://bit.ly/lib-api-pycon

https://www.nngroup.com/articles/ten-usability-heuristics/
http://www.usabilitybok.org/principles-for-usable-design
https://medium.com/@nirbenita/the-10-design-heuristics-for-developers-1e70a9dc58a7
https://blog.prototypr.io/10-usability-heuristics-with-examples-4a81ada920c
https://speakerdeck.com/pybay/2016-alex-martelli-the-tower-of-abstraction
http://www.usabilitybok.org/principles-for-usable-design
https://www.slideshare.net/choult/your-api-is-a-ui
http://queue.acm.org/detail.cfm?id=1071731
https://www.reddit.com/r/Python/comments/48q804/whats_the_worst_package_youve_ever_worked_with/
http://www.aleax.it/europ11_adap.pdf
http://paulbuchheit.blogspot.com.br/2007/05/amazingly-bad-apis.html
https://speakerdeck.com/labcodes/sua-api-e-uma-user-interface
https://github.com/matthiasn/talk-transcripts/blob/master/Hickey_Rich/SimpleMadeEasy.md
https://www.reddit.com/r/Python/comments/4y39cc/what_the_most_well_designed_written_and_tested/?st=j281ama6&sh=8badc9ad
https://www.reddit.com/r/Python/comments/1ls7vq/best_written_projects_on_python_github/?st=j27xyi5n&sh=4dcfface
https://www.reddit.com/r/Python/comments/211jc3/for_beginners_what_are_the_most_important_python/?st=j2dnfs7d&sh=39edab92
https://github.com/vinta/awesome-python
https://speakerdeck.com/pycon2014/designing-poetic-apis-by-erik-rose
http://wiki.c2.com/?AreDesignPatternsMissingLanguageFeatures
https://softwareengineering.stackexchange.com/questions/157943/are-there-any-design-patterns-that-are-unnecessary-in-dynamic-languages-like-pyt
http://stackoverflow.com/questions/1661262/check-if-object-is-file-like-in-python
http://www.aleax.it/gdd_pydp.pdf
http://ginstrom.com/scribbles/2009/03/27/the-adapter-pattern-in-python/
http://ginstrom.com/scribbles/2007/10/08/design-patterns-python-style/
https://leaverou.github.io/talks/jsux/#intro
https://www.sandimetz.com/blog/2016/1/20/the-wrong-abstraction
https://www.joelonsoftware.com/2002/11/11/the-law-of-leaky-abstractions/
http://tomasp.net/blog/2015/library-layers/
http://tomasp.net/blog/2015/library-frameworks/
https://eev.ee/blog/2012/04/09/php-a-fractal-of-bad-design/
https://wiki.qt.io/API_Design_Principles
http://www.cs.bc.edu/~muller/teaching/cs102/s06/lib/pdf/api-design
http://queue.acm.org/detail.cfm?id=1255422
https://softwareengineering.stackexchange.com/questions/196151/what-guidelines-should-i-follow-while-designing-a-library
https://medium.com/pointer-io/this-article-is-exclusive-to-pointer-a-reading-club-for-developers-9b03f3df060c
http://www.thereformedprogrammer.net/what-makes-a-good-software-library/
https://medium.com/@mbostock/what-makes-software-good-943557f8a488
http://mattgemmell.com/api-design/
http://www.yacoset.com/Home/api-design-tips
http://people.mpi-inf.mpg.de/~jblanche/api-design.pdf
https://mollyrocket.com/casey/stream_0028.html
https://ep2013.europython.eu/media/conference/slides/good-api-design.pdf
https://www.slideshare.net/crafted/10-usability-heuristics-explained

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment