Thursday, February 22, 2007

API prime directives

In my recent tearful apology to the victims of the M5a build and their families, I made a reference to the Eclipse API prime directive that deserves further explanation. The accurate quote is:

API Usage Assumption: Every aspect of the API matters to some Client.

This quote comes from a seminal document written by Eclipse veteran Jim Des Rivieres who was in his time known as 'the API Police'. He struck fear in many a component lead when the time came to inspect the APIs before the freeze. Jim is now busy doing other interesting things (although he still lovingly prepares Eclipse New&Noteworthy for the milestone builds), but I encourage every committer to frequently come back to the said document, particularly when she prepares for the major API surgery (note from the revision history that the document has been kept fresh, most recently updated to include rules related to JDK 1.5).

Read the document and you will learn how to walk the razor-thin line between the API bliss and the M5a.

6 comments:

Mike said...

And in my limited experience, I have noticed the users of the most obscure and ill-conceived parts of a given API are the most vocal ; )

Chris Aniszczyk (zx) said...

holy crap, I learned quite a bit from reading that document.

I think some pictures would help, that's a lot of text to parse and commit to memory.

Anonymous said...

Now do you worried about that in the game do not had enough Archlord gold to play the game, now you can not worried, my friend told me a website, in here you can buy a lot Archlord money and only spend a little money, do not hesitate, it was really, in here we had much archlord online Gold, we can sure that you will get the cheap Archlord gold, quick to come here to buy Archlord gold.

Now do you worried about that in the game do not had enough Atlantica online Gold to play the game, now you can not worried, my friend told me a website, in here you can buy a lot Atlantica Gold and only spend a little money, do not hesitate, it was really, in here we had much Atlantica online money, we can sure that you will get the cheap Atlantica online Gold , quick to come here to buy Atlantica online Gold .

Anonymous said...

Amiable fill someone in on and this enter helped me alot in my college assignement. Thank you for your information.

Anonymous said...

It is your responsibility whether you will join or not. There are lots of sports betting websites that offers free registration and offers also free points to attract newcomers. You are also not restricted; you can place your bet wherever you are; Some website are customized to suit your language and understand the things and happenings on the game, also included the cash converted to your currency, so you know how much you bet or the equivalent of your bet on your currency. But then again, as you enjoy the online sports betting, you are responsible on what might be the outcome of your transactions online. [url=http://www.pulsebet.com/bg/]bet online[/url] [url=http://www.pulsebet.com/da/]bet online[/url] [url=http://www.pulsebet.com/de/]bet online[/url] [url=http://www.pulsebet.com/es]apuestas[/url] [url=http://www.pulsebet.com/fr/]jouer en ligne[/url] [url=http://www.pulsebet.com/gr]bet online[/url] [url=http://www.pulsebet.com/jp]bet online[/url] [url=http://www.pulsebet.com/nl]bet online[/url] [url=http://www.pulsebet.com/pl]bet online[/url] [url=http://www.pulsebet.com/pt]bet online[/url] [url=http://www.pulsebet.com/ro]bet online[/url] [url=http://www.pulsebet.com/ru]bet online[/url] [url=http://www.pulsebet.com/se]bet online[/url] [url=http://www.pulsebet.com/it]bet online[/url] [url=http://www.pulsebet.com/cn]bet online[/url] Now that sports betting has become a larger and more accepted practice, sportsbooks have risen above their disreputable bookies to enter the digital age. Online sportsbooks now have the security of being a large company ensuring the best benefits for any bettor. Sportsbooks will take your bets in exchange for a commission which is usually a percentage of the wager. This is also known as the juice, vig or vigorish. In theory, the sportsbooks don't care who you bet on. They simply take half of their bets on each side and make their commission. http://www.pulsebet.com/bg/ http://www.pulsebet.com/da/ http://www.pulsebet.com/de/ http://www.pulsebet.com/es/ http://www.pulsebet.com/fr/ http://www.pulsebet.com/gr/ http://www.pulsebet.com/jp/ http://www.pulsebet.com/nl/ http://www.pulsebet.com/pl/ http://www.pulsebet.com/pt/ http://www.pulsebet.com/ro/ http://www.pulsebet.com/ru/ http://www.pulsebet.com/se/ http://www.pulsebet.com/it/ http://www.pulsebet.com/cn/

Anonymous said...

Thereafter you will be given a free bet voucher that you can utilize while betting anyplace in the betting market. Mind you the football betting is given no sooner the match gets over and the winning amount is automatically added to the bettor’s account. nfl betting baseball betting basketball betting boxing betting cricket betting darts betting football betting golf betting handball betting hockey betting rugby betting snooker betting tennis betting An online sportsbook is a site where patrons can bet on different sports competitions including golf, football, basketball, baseball, hockey, soccer, horse racing, boxing, and just about any other sport you can think of. The method of betting differs with the sport and the type of the game being played. In the United States there are about 150 legal sportsbooks that are situated in Nevada. Betting on sports is fully legal in many countries and it is well known with people who like to gamble. [url=http://www.pulsebet.com/betting/American-Football]nfl betting[/url] [url=http://www.pulsebet.com/betting/Baseball-betting]baseball betting[/url] [url=http://www.pulsebet.com/betting/Basketball-betting]basketball betting[/url] [url=http://www.pulsebet.com/betting/Boxing-betting]boxing betting[/url] [url=http://www.pulsebet.com/betting/Cricket-betting]cricket betting[/url] [url=http://www.pulsebet.com/betting/Darts-betting]darts betting[/url] [url=http://www.pulsebet.com/betting/Football-betting]football betting[/url] [url=http://www.pulsebet.com/betting/Golf-betting]golf betting[/url] [url=http://www.pulsebet.com/betting/Handball-betting]handball betting[/url] [url=http://www.pulsebet.com/betting/Hockey-betting]hockey betting[/url] [url=http://www.pulsebet.com/betting/Rugby-betting]rugby betting[/url] [url=http://www.pulsebet.com/betting/Snooker-betting]snooker betting[/url] [url=http://www.pulsebet.com/betting/Tennis-betting]tennis betting[/url] Always remember that while betting whatever amount of bets you have placed cannot be changed afterwards. Therefore, it is essential that to place bets with complete understanding and thinking. So are you perplexed? Just search you best football tips, Bookmaker reviews, free betting tips and earn hefty profits. http://www.pulsebet.com/betting/American-Football http://www.pulsebet.com/betting/Baseball-betting http://www.pulsebet.com/betting/Basketball-betting http://www.pulsebet.com/betting/Boxing-betting http://www.pulsebet.com/betting/Cricket-betting http://www.pulsebet.com/betting/Darts-betting http://www.pulsebet.com/betting/Football-betting http://www.pulsebet.com/betting/Golf-betting http://www.pulsebet.com/betting/Handball-betting http://www.pulsebet.com/betting/Hockey-betting http://www.pulsebet.com/betting/Rugby-betting http://www.pulsebet.com/betting/Snooker-betting http://www.pulsebet.com/betting/Tennis-betting