5 ms·
The Little Manual of API Design
- aleemb 15y agoAlso noteworthy is the "How to Design a Good API & Why it Matters" talk video: http://www.youtube.com/watch?v=aAb7hSCtvGw http://www.youtube.com/watch?v=aAb7hSCtvGw pdf: http://lcsd05.cs.tamu.edu/slides/keynote.pdf http://lcsd05.cs.tamu.edu/slides/keynote.pdf
- aeden 15y agoThis is an excellent little PDF that was very useful to me when I put together a recent talk titled "API Design Matters". It's amazing how a bit of energy spent focusing on an API's design can improve so many aspects of both using and developing said API.
- wmat 15y agoThanks for this post! This is the kind of content I wish HN had more of.
- xiaoqmaxkk 15y agowelcometo: http://www.fullmalls.com http://www.fullmalls.com The website wholesale for many kinds of fashion shoes, like the nike,jordan,prada,, also including the jeans,shirts,bags,hat and the decorations. All the products are free shipping, and the the price is competitive, and also can accept the paypal payment.,after the payment, can ship within short time. free shippingcompetitive priceany size availableaccept the paypal ===== http://www.fullmalls.com http://www.fullmalls.com ===== jordan shoes $32nike shox $32Christan Audigier bikini $23 Ed Hardy Bikini $23Smful short_t-shirt_woman $15ed hardy short_tank_woman $16Sandal $32christian loubo utin $80 Sunglass $15 COACH_Necklace $27handbag $33AF tank woman $17puma slipper woman $30 ===== http://www.fullmalls.com http://www.fullmalls.com ===== ===== http://www.fullmalls.com http://www.fullmalls.com ===== ===== http://www.fullmalls.com http://www.fullmalls.com ===== ===== http://www.fullmalls.com http://www.fullmalls.com ===== ===== http://www.fullmalls.com http://www.fullmalls.com =====
- smunz 15y agoAbsolutely. Any suggestions for places to find more content like this? Not to leave HN, just to complement it ;)
- aeden 15y agoThere is surprisingly little written about good API design. Maybe it's because the important things to say have already been said, but I have my doubts that that is the reason.
- robbles 15y agoI suspect it's partly because of the difficulty involved in measuring the quality of a given API's design. How do you separate the success resulting from the usefulness or popularity of the technology from the design of the API? That was the first thing I though on starting to read this. How do they know they've actually got it right? Feedback from users?
- mun2mun 15y agoThere was a discussion in reddit about pthread api design http://www.reddit.com/r/programming/comments/bmnkl/pthreads_as_a_case_study_of_good_api_design/ http://www.reddit.com/r/programming/comments/bmnkl/pthreads_... . Edit: sorry this was replied to smunz's comment.
- rplacd 15y agoIf you're looking to save this link, it's on Proggit.
- wickedchicken 15y agoOne library I've found very useful to study is libcurl -- it has a very elegant degradation system. Easy things start out easy, and when the user chooses to handle more complexity she can switch to a lower-level set of calls.
- Chris_Newton 15y agoOne of the most interesting things I ever saw about API design was a presentation by Casey Muratori called "Designing and Evaluating Reusable Components". It's the first time I saw anyone acknowledge this profound insight: sometimes, writing a practically useful API entirely at the same level of abstraction simply isn't possible. Looks like it's available here, now: http://mollyrocket.com/9438 http://mollyrocket.com/9438
- woogley 15y agoPDF version: http://www4.in.tum.de/~blanchet/api-design.pdf http://www4.in.tum.de/~blanchet/api-design.pdf
- ramchip 15y agoThe link is to the PDF version already. It will take you to Scribd only if you click the [scribd] part.
- clintjhill 15y agoI appreciate the small reference to "The Elements of Style" by Strunk. That book has helped me refine not only my writing but also my software design.
- robjohnson 15y agoAPI design is something I have been meaning to look into - thanks for the link.