Paradoxes of API Design - Revision history

JaroslavTulach: /* Video */

JaroslavTulach — Mon, 06 Apr 2026 05:23:08 GMT

Video

←Older revision		Revision as of 05:23, 6 April 2026
Line 3:		Line 3:
	Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem [[paradox]]ical. However that does not mean such advice is not useful and the [[Paradoxes of API Design\|chapter 14]] describes some of them and explains why adhering to them may be beneficial for any software project.		Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem [[paradox]]ical. However that does not mean such advice is not useful and the [[Paradoxes of API Design\|chapter 14]] describes some of them and explains why adhering to them may be beneficial for any software project.

-	== Video ==	+	== [[ParadoxesVideo\|Video]] ==

	{{:ParadoxesVideo}}		{{:ParadoxesVideo}}

JaroslavTulach at 06:35, 17 June 2020

JaroslavTulach — Wed, 17 Jun 2020 06:35:29 GMT

←Older revision		Revision as of 06:35, 17 June 2020
Line 14:		Line 14:

	{{:Trust}}		{{:Trust}}
		+
		+	== The [[InvisibleJob]] ==
		+
		+	{{:InvisibleJob}}

JaroslavTulach: /* Money or Trust? */

JaroslavTulach — Mon, 05 Nov 2018 10:26:43 GMT

Money or Trust?

←Older revision		Revision as of 10:26, 5 November 2018
Line 11:		Line 11:
	{{:Paradox}}		{{:Paradox}}

-	== Money or Trust? ==	+	== Money or [[Trust]]? ==

-	The [[Chapter 14]] also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.	+	{{:Trust}}
-		+
-	~~I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel~~:	+
-		+
-	''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''	+
-	~~[http://bigbubbas.wordpress.com bbq pits smokers]~~	+
-		+
-	~~Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]~~	+
-		+
-	~~Does that mean we need more [[BackwardCompatibility]] in our APIs in order to prevent collapse of software industry comparable to the one on financial markets?~~	+
-		+
-	~~--[[User:JaroslavTulach\|JaroslavTulach]] 10:19, 30 September 2008 (UTC)~~	+

JaroslavTulach: /* Money or Trust? */

JaroslavTulach — Mon, 05 Nov 2018 10:26:00 GMT

Money or Trust?

←Older revision		Revision as of 10:26, 5 November 2018
Line 13:		Line 13:
	== Money or Trust? ==		== Money or Trust? ==

-	~~This chapter~~ also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.	+	The [[Chapter 14]] also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.

	I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:		I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:

Apidesign: Reverted edits by Apidesign (Talk); changed back to last version by Cloudnine189

Apidesign — Thu, 11 Oct 2012 13:53:05 GMT

Reverted edits by Apidesign (Talk); changed back to last version by Cloudnine189

←Older revision		Revision as of 13:53, 11 October 2012
Line 18:		Line 18:

	''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''		''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''
		+	[http://bigbubbas.wordpress.com bbq pits smokers]

	Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]		Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]

Apidesign: Reverted edits by Cloudnine189 (Talk); changed back to last version by Apidesign

Apidesign — Thu, 11 Oct 2012 13:50:42 GMT

Reverted edits by Cloudnine189 (Talk); changed back to last version by Apidesign

←Older revision		Revision as of 13:50, 11 October 2012
Line 18:		Line 18:

	''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''		''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''
-	~~[http://bigbubbas.wordpress.com bbq pits smokers]~~

	Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]		Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]

Cloudnine189 at 04:53, 9 October 2012

Cloudnine189 — Tue, 09 Oct 2012 04:53:47 GMT

←Older revision		Revision as of 04:53, 9 October 2012
Line 18:		Line 18:

	''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''		''Trust is a reciprocal relationship, dependent upon a desire to be considered decent and honourable. Even in the dog-eat-dog financial markets, trust and integrity are matters of self-interest. However amoral you may be, it is in your interest to care about your reputation, because if you behave badly you will not do business with me - or others - on favourable terms again. Trust matters.''
		+	[http://bigbubbas.wordpress.com bbq pits smokers]

	Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]		Will Hutton, [http://www.guardian.co.uk/commentisfree/2008/sep/28/globaleconomy.creditcrunch Guardian]

Apidesign: Reverted edits by DanielCobb (Talk); changed back to last version by JaroslavTulach

Apidesign — Mon, 29 Nov 2010 21:30:42 GMT

Reverted edits by DanielCobb (Talk); changed back to last version by JaroslavTulach

←Older revision		Revision as of 21:30, 29 November 2010
Line 13:		Line 13:
	== Money or Trust? ==		== Money or Trust? ==

-	This chapter also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients ~~and [http://www.asiawriters.com/ essay writers]~~ of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.	+	This chapter also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.

	I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:		I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:

DanielCobb at 19:51, 29 November 2010

DanielCobb — Mon, 29 Nov 2010 19:51:23 GMT

←Older revision		Revision as of 19:51, 29 November 2010
Line 13:		Line 13:
	== Money or Trust? ==		== Money or Trust? ==

-	This chapter also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.	+	This chapter also contains a note about the importance of trust in the API design. If you broke your promise of [[BackwardCompatibility]] once, you repel clients and [http://www.asiawriters.com/ essay writers] of your API to alternative offerings. It is hard for them to believe that they should once again build their application on top of your API and risk similar problems again.

	I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:		I compared this situation with the importance of trust among banks and today, in the days of worldwide financial problems, I've found confirmation of my parallel:

JaroslavTulach: /* Have You Ever Wondered...? */

JaroslavTulach — Tue, 12 Jan 2010 11:29:27 GMT

Have You Ever Wondered...?

←Older revision		Revision as of 11:29, 12 January 2010
Line 2:		Line 2:

	Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem [[paradox]]ical. However that does not mean such advice is not useful and the [[Paradoxes of API Design\|chapter 14]] describes some of them and explains why adhering to them may be beneficial for any software project.		Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem [[paradox]]ical. However that does not mean such advice is not useful and the [[Paradoxes of API Design\|chapter 14]] describes some of them and explains why adhering to them may be beneficial for any software project.
		+
		+	== Video ==

	{{:ParadoxesVideo}}		{{:ParadoxesVideo}}