Theory and Justification - Revision history

JaroslavTulach at 05:28, 29 July 2018

2018-07-29T05:28:29Z

←Older revision	Revision as of 05:28, 29 July 2018
Line 1:	Line 1:
	+	Part 1 of the [[TheAPIBook]] is dedicated to [[Theory and Justification]].

	+	* Chapter 1: [[The Art of Building Modern Software]]
	+	* Chapter 2: [[The Motivation to Create an API]]
	+	* Chapter 3: [[Determining What Makes a Good API]]
	+	* Chapter 4: [[Ever Changing Targets]]
	+
	+	These observations are still valid even [[TenYears]] after [[TheAPIBook]] publication.

Apidesign: Removing all content from page

2008-06-14T05:16:27Z

Removing all content from page

←Older revision		Revision as of 05:16, 14 June 2008
Line 1:		Line 1:
-	* "In that case, developers using it will
-	~~create a feeling way different that conflicts with~~
-	~~the architect's intentions." does not make such sense.~~
-	** '''0d79391726e3'''

-	~~--[[User:JesseGlick\|JesseGlick]] 03:44, 25 March 2008 (UTC)~~
-
-	* There are no page numbers on this section
-	* Punc: Para 2: Delete comma after API - it's not necessary
-	* Content: Para 2: This is the perfect place to hint at some counter-examples of consistency in Java... unfortunately, I'm having some trouble coming up with examples right now! (things like A.size(), B.size(), C.getSize(), or A.toInt(), B.toInt(), C.getInt() or something)
-	* Spacing: Para "A Stable API" - is there an extra space before "API is stable" in italics?
-	* References: Para "If you believe" - "Part __" missing Part numbers (twice).
-	~~--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)~~
-
-	* I agree with Jesse's comment that the last sentence in the first paragraph doesn't make sense. I'd perhaps suggest "In that case, developers will use it in a way that conflicts with the architect's intentions".
-	* (wording) para 1: "the API architect is an artist..." => "the API architect is either an artist..."
-	* (wording) para 2: "the API users" => "the API's users"
-	* (spelling) first page, last paragraph: "deja vu" => "déjà vu"
-	~~--[[User:AdamDingle\|AdamDingle]] 22:57, 27 March 2008 (UTC)~~
-
-	* "I found proof this a year later" should be "I found proof of this a year later"
-	** '''0d79391726e3'''
-	~~--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008~~
-
-	* If the anecdote in "Design By Committee" refers to xml-tree, then that external developer was me, soon after university and very green on APIs :-)
-	** I did not know, that is cute.
-	~~--[[User:RichUnger\|RichUnger]] Thu Mar 27 20:28:22 CDT 2008~~

JaroslavTulach at 06:23, 5 April 2008

2008-04-05T06:23:31Z

←Older revision		Revision as of 06:23, 5 April 2008
Line 1:		Line 1:
-	"In that case, developers using it will	+	* "In that case, developers using it will
	create a feeling way different that conflicts with		create a feeling way different that conflicts with
	the architect's intentions." does not make such sense.		the architect's intentions." does not make such sense.
		+	** '''0d79391726e3'''

	--[[User:JesseGlick\|JesseGlick]] 03:44, 25 March 2008 (UTC)		--[[User:JesseGlick\|JesseGlick]] 03:44, 25 March 2008 (UTC)
Line 19:		Line 20:

	* "I found proof this a year later" should be "I found proof of this a year later"		* "I found proof this a year later" should be "I found proof of this a year later"
		+	** '''0d79391726e3'''
	--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008		--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008

	* If the anecdote in "Design By Committee" refers to xml-tree, then that external developer was me, soon after university and very green on APIs :-)		* If the anecdote in "Design By Committee" refers to xml-tree, then that external developer was me, soon after university and very green on APIs :-)
		+	** I did not know, that is cute.
	--[[User:RichUnger\|RichUnger]] Thu Mar 27 20:28:22 CDT 2008		--[[User:RichUnger\|RichUnger]] Thu Mar 27 20:28:22 CDT 2008

71.131.199.190 at 03:29, 28 March 2008

2008-03-28T03:29:32Z

←Older revision		Revision as of 03:29, 28 March 2008
Line 20:		Line 20:
	* "I found proof this a year later" should be "I found proof of this a year later"		* "I found proof this a year later" should be "I found proof of this a year later"
	--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008		--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008
		+
		+	* If the anecdote in "Design By Committee" refers to xml-tree, then that external developer was me, soon after university and very green on APIs :-)
		+	--[[User:RichUnger\|RichUnger]] Thu Mar 27 20:28:22 CDT 2008

Tomwheeler at 02:20, 28 March 2008

2008-03-28T02:20:00Z

←Older revision		Revision as of 02:20, 28 March 2008
Line 17:		Line 17:
	* (spelling) first page, last paragraph: "deja vu" => "déjà vu"		* (spelling) first page, last paragraph: "deja vu" => "déjà vu"
	--[[User:AdamDingle\|AdamDingle]] 22:57, 27 March 2008 (UTC)		--[[User:AdamDingle\|AdamDingle]] 22:57, 27 March 2008 (UTC)
		+
		+	* "I found proof this a year later" should be "I found proof of this a year later"
		+	--[[User:TomWheeler\|TomWheeler]] Thu Mar 27 21:16:22 CDT 2008

AdamDingle at 22:57, 27 March 2008

2008-03-27T22:57:53Z

←Older revision		Revision as of 22:57, 27 March 2008
Line 11:		Line 11:
	* References: Para "If you believe" - "Part __" missing Part numbers (twice).		* References: Para "If you believe" - "Part __" missing Part numbers (twice).
	--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)		--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)
		+
		+	* I agree with Jesse's comment that the last sentence in the first paragraph doesn't make sense. I'd perhaps suggest "In that case, developers will use it in a way that conflicts with the architect's intentions".
		+	* (wording) para 1: "the API architect is an artist..." => "the API architect is either an artist..."
		+	* (wording) para 2: "the API users" => "the API's users"
		+	* (spelling) first page, last paragraph: "deja vu" => "déjà vu"
		+	--[[User:AdamDingle\|AdamDingle]] 22:57, 27 March 2008 (UTC)

Dmkoelle at 20:52, 26 March 2008

2008-03-26T20:52:22Z

←Older revision		Revision as of 20:52, 26 March 2008
Line 7:		Line 7:
	* There are no page numbers on this section		* There are no page numbers on this section
	* Punc: Para 2: Delete comma after API - it's not necessary		* Punc: Para 2: Delete comma after API - it's not necessary
-	* Content: Para 2: This is the perfect place to hint at some counter-examples of consistency in Java... unfortunately, I'm having some trouble coming up with examples right now!	+	* Content: Para 2: This is the perfect place to hint at some counter-examples of consistency in Java... unfortunately, I'm having some trouble coming up with examples right now! (things like A.size(), B.size(), C.getSize(), or A.toInt(), B.toInt(), C.getInt() or something)
	* Spacing: Para "A Stable API" - is there an extra space before "API is stable" in italics?		* Spacing: Para "A Stable API" - is there an extra space before "API is stable" in italics?
	* References: Para "If you believe" - "Part __" missing Part numbers (twice).		* References: Para "If you believe" - "Part __" missing Part numbers (twice).
	--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)		--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)

Dmkoelle at 20:50, 26 March 2008

2008-03-26T20:50:58Z

←Older revision		Revision as of 20:50, 26 March 2008
Line 4:		Line 4:

	--[[User:JesseGlick\|JesseGlick]] 03:44, 25 March 2008 (UTC)		--[[User:JesseGlick\|JesseGlick]] 03:44, 25 March 2008 (UTC)
		+
		+	* There are no page numbers on this section
		+	* Punc: Para 2: Delete comma after API - it's not necessary
		+	* Content: Para 2: This is the perfect place to hint at some counter-examples of consistency in Java... unfortunately, I'm having some trouble coming up with examples right now!
		+	* Spacing: Para "A Stable API" - is there an extra space before "API is stable" in italics?
		+	* References: Para "If you believe" - "Part __" missing Part numbers (twice).
		+	--[[User:Dmkoelle\|Dmkoelle]] 20:50, 26 March 2008 (UTC)

JesseGlick: New page: "In that case, developers using it will create a feeling way different that conflicts with the architect's intentions." does not make such sense. --~~~~

2008-03-25T03:44:23Z

New page: "In that case, developers using it will create a feeling way different that conflicts with the architect's intentions." does not make such sense. --~~~~

New page

"In that case, developers using it will
create a feeling way different that conflicts with
the architect's intentions." does not make such sense.

--[[User:JesseGlick|JesseGlick]] 03:44, 25 March 2008 (UTC)