<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/css" href="http://wiki.apidesign.org/skins/common/feed.css?116"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
		<id>http://wiki.apidesign.org/index.php?action=history&amp;feed=atom&amp;title=1stPublicReview</id>
		<title>1stPublicReview - Revision history</title>
		<link rel="self" type="application/atom+xml" href="http://wiki.apidesign.org/index.php?action=history&amp;feed=atom&amp;title=1stPublicReview"/>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;action=history"/>
		<updated>2026-05-22T01:31:26Z</updated>
		<subtitle>Revision history for this page on the wiki</subtitle>
		<generator>MediaWiki 1.12.0rc1</generator>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1326&amp;oldid=prev</id>
		<title>JaroslavTulach at 07:47, 3 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1326&amp;oldid=prev"/>
				<updated>2008-09-03T07:47:52Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 07:47, 3 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. The comment is very likely true. I have to admit, especially after the confession I made at the end of [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, &lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;opinions&lt;/del&gt;, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. The comment is very likely true. I have to admit, especially after the confession I made at the end of [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;ideas, stories&lt;/ins&gt;, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1325&amp;oldid=prev</id>
		<title>JaroslavTulach at 07:46, 3 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1325&amp;oldid=prev"/>
				<updated>2008-09-03T07:46:15Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 07:46, 3 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;There is a [[1stPublicReview|review]] of [[TheAPIBook]]! [[GeertjanWielenga|Geertjan]] just &lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;send &lt;/del&gt;me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''&lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;This &lt;/del&gt;is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;There is a [[1stPublicReview|review]] of [[TheAPIBook]]! [[GeertjanWielenga|Geertjan]] &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;had &lt;/ins&gt;just &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;sent &lt;/ins&gt;me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''&lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;this &lt;/ins&gt;is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1324&amp;oldid=prev</id>
		<title>JaroslavTulach at 19:47, 2 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1324&amp;oldid=prev"/>
				<updated>2008-09-02T19:47:02Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 19:47, 2 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. The comment is very likely true. I have to admit, especially after the confession I made &lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;in &lt;/del&gt;[[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. The comment is very likely true. I have to admit, especially after the confession I made &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;at the end of &lt;/ins&gt;[[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1323&amp;oldid=prev</id>
		<title>JaroslavTulach at 19:46, 2 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1323&amp;oldid=prev"/>
				<updated>2008-09-02T19:46:36Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 19:46, 2 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for such readers, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. &lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;Very &lt;/del&gt;likely true. I have to admit, especially after the confession I made in [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;The comment is very &lt;/ins&gt;likely true. I have to admit, especially after the confession I made in [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1322&amp;oldid=prev</id>
		<title>JaroslavTulach at 19:46, 2 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1322&amp;oldid=prev"/>
				<updated>2008-09-02T19:46:11Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 19:46, 2 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;There is a [[1stPublicReview|review]] of [[TheAPIBook]]! [[GeertjanWielenga|Geertjan]] just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''This is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;There is a [[1stPublicReview|review]] of [[TheAPIBook]]! [[GeertjanWielenga|Geertjan]] just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''This is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for &lt;del style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;those&lt;/del&gt;, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for &lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;such readers&lt;/ins&gt;, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. Very likely true. I have to admit, especially after the confession I made in [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;The other interesting comment was about the subtitle: ''confessions''. Very likely true. I have to admit, especially after the confession I made in [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1321&amp;oldid=prev</id>
		<title>JaroslavTulach at 19:43, 2 September 2008</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1321&amp;oldid=prev"/>
				<updated>2008-09-02T19:43:45Z</updated>
		
		<summary type="html">&lt;p&gt;&lt;/p&gt;

			&lt;table style=&quot;background-color: white; color:black;&quot;&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;col class='diff-marker' /&gt;
			&lt;col class='diff-content' /&gt;
			&lt;tr&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;←Older revision&lt;/td&gt;
				&lt;td colspan='2' style=&quot;background-color: white; color:black;&quot;&gt;Revision as of 19:43, 2 September 2008&lt;/td&gt;
			&lt;/tr&gt;
		&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 1:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt;-&lt;/td&gt;&lt;td style=&quot;background: #ffa; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;[[GeertjanWielenga|Geertjan]] just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''This is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt;+&lt;/td&gt;&lt;td style=&quot;background: #cfc; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;color: red; font-weight: bold; text-decoration: none;&quot;&gt;There is a [[1stPublicReview|review]] of [[TheAPIBook]]! &lt;/ins&gt;[[GeertjanWielenga|Geertjan]] just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''This is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for those, I guess.&lt;/div&gt;&lt;/td&gt;&lt;td class='diff-marker'&gt; &lt;/td&gt;&lt;td style=&quot;background: #eee; color:black; font-size: smaller;&quot;&gt;&lt;div&gt;Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for those, I guess.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>JaroslavTulach</name></author>	</entry>

	<entry>
		<id>http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1318&amp;oldid=prev</id>
		<title>213.220.235.54: New page: Geertjan just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of ...</title>
		<link rel="alternate" type="text/html" href="http://wiki.apidesign.org/index.php?title=1stPublicReview&amp;diff=1318&amp;oldid=prev"/>
				<updated>2008-09-02T19:40:15Z</updated>
		
		<summary type="html">&lt;p&gt;New page: &lt;a href=&quot;/wiki/GeertjanWielenga&quot; title=&quot;GeertjanWielenga&quot;&gt;Geertjan&lt;/a&gt; just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of ...&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;[[GeertjanWielenga|Geertjan]] just send me a link to the [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/ first public review] of the [[TheAPIBook]]. I was a bit nervous to open the page. I was not sure whether to get ready for absolute criticism or words expressing usefulness of [[TheAPIBook]]. I guess that a review which says ''This is without a doubt a book that you need to put on your bookshelf. This is the first book of its kind and the tips and tricks that it provides is timeless - a key attribute of any pragmatic software development book'' can only be seen in positive light. Thanks for the nice review, [http://72miles.com/blog/posts/practical-api-design-confessions-of-a-java-framework-architect-book-reivew/  Mike].&lt;br /&gt;
&lt;br /&gt;
Now on to the critical comments. Yes, I know the first part of the book, the theory, maybe seen as something delaying the real pleasure - the practical code samples. In [[Have_You_Ever_Wondered|some sense it does]], however I just felt that given the wide audience of readers (just to quote the reviewer ''this book is really much more for anyone who writes code that anyone else consumes - and who doesn’t do that? This book is for any developer who is not brand new to software development''), I felt the need to get everyone on the speed, clean up the terminology, make sure we understand each other. Maybe I was too careful, as [[RichUnger]] said: ''you do not need your readers to agree with you 100%, maybe 99% is enough''. Well, I targeted for the 100%, and as a result, the book may be seen ''slow'' for those who are already on the same boat. Still, it has a lot of ''meat'' even for those, I guess.&lt;br /&gt;
&lt;br /&gt;
The other interesting comment was about the subtitle: ''confessions''. Very likely true. I have to admit, especially after the confession I made in [[Ever_Changing_Targets|Chapter 4]], that I have never been to a confession. My understanding of that term is really vague. However, we needed the subtitle to stress, that the book is not opinion neutral, that it contains personal experiences, opinions, etc. When [[ThanksEveryone#Clay_Andres|Clay]] suggested to use ''confessions'', I felt, yes, that is sort of what I am actually doing. Maybe this is not absolutely correct, but it helps set the right expectations up. At least I hope.&lt;br /&gt;
&lt;br /&gt;
I really like Mike saying: ''After reading many chapters, I went right to my open source project, [http://code.google.com/p/architecturerules/ Architecture Rules], and either changed code or emailed developer mailing list to suggest changes to code to encourage a better, more malleable and extensible API.'' Yes, this is it! This is the reason why I wrote [[TheAPIBook]]. Software for 21st century needs to be modular, needs to be well evolved and I am glad that [[TheAPIBook|my book]] can contribute to that.&lt;br /&gt;
&lt;br /&gt;
Thanks for such nice review and I am eagerly waiting to see more. Btw. if you ever feel you have a note to share about API Design, feel free to jump on the [[Main_Page|apidesign.org]] wiki.&lt;/div&gt;</summary>
		<author><name>213.220.235.54</name></author>	</entry>

	</feed>