The Artima Developer Community
Sponsored Link

Agile Buzz Forum
API Design, part I

0 replies on 1 page.

Welcome Guest
  Sign In

Go back to the topic listing  Back to Topic List Click to reply to this topic  Reply to this Topic Click to search messages in this forum  Search Forum Click for a threaded view of the topic  Threaded View   
Previous Topic   Next Topic
Flat View: This topic has 0 replies on 1 page
Jimmy Nilsson

Posts: 694
Nickname: jimmyn
Registered: Aug, 2003

Jimmy Nilsson is a developer, author and trainer for JNSK in Sweden.
API Design, part I Posted: Feb 25, 2008 7:25 AM
Reply to this message Reply

This post originated from an RSS feed registered with Agile Buzz by Jimmy Nilsson.
Original Post: API Design, part I
Feed Title: Jimmy Nilsson's weblog
Feed URL: http://www.jnsk.se/weblog/rss.xml
Feed Description: Patterns, OO, DB, .NET, ...
Latest Agile Buzz Posts
Latest Agile Buzz Posts by Jimmy Nilsson
Latest Posts From Jimmy Nilsson's weblog

Advertisement

API Design might to some not be the coolest thing around, but if you ask me it's extremely important. A few months ago I was playing with it a little and came up with a list that is inspired by the Agile Manifesto:

API design manifesto
:-)

  • Code over comments
  • Immutability over mutability
  • Testability over encapsulation
  • Context over generality
  • Small and simple over completeness
  • Backward compatibility over revolution
  • Encapsulation over transparency
I know, I need to explain my thinking for each line above. I think I'll put it into a series of blog posts, but first I'd like to improve the list. A few weeks ago I discussed this topic with a couple of friends at a workshop and I got loads of ideas about how to improve it. Before starting the work I also wanted ask around here for even more input. If you have ideas, please email me: jimmy dot nilsson at factor10 dot com.

Read: API Design, part I

Topic: Smalltalk Daily 2/22/08: Smalltalk Syntax 3 Previous Topic   Next Topic Topic: YAGNI could have been used here

Sponsored Links



Google
  Web Artima.com   

Copyright © 1996-2019 Artima, Inc. All Rights Reserved. - Privacy Policy - Terms of Use