Theory and Justification

Revision as of 22:57, 27 March 2008 by AdamDingle (Talk | contribs)

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

--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).

--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"

--AdamDingle 22:57, 27 March 2008 (UTC)