Blogs:JaroslavTulach:Daily Life:YetAnotherAwesomeReview

JaroslavTulach at 20:09, 7 March 2009 - 2009-03-07 20:09:47

←Older revision		Revision as of 20:09, 7 March 2009
Line 3:		Line 3:
	However after thinking about it for a bit more, I believe that I do not need to persecute myself for writing [[TheAPIBook\|the book]]. I knew the book is not complete, I knew its selection of topics is subjective and related to my own experience (hence the word ''Practical'' in the title), yet the book is still more useful out than kept just in my head and notes.		However after thinking about it for a bit more, I believe that I do not need to persecute myself for writing [[TheAPIBook\|the book]]. I knew the book is not complete, I knew its selection of topics is subjective and related to my own experience (hence the word ''Practical'' in the title), yet the book is still more useful out than kept just in my head and notes.

-	I ~~just~~ have to repeat the theme of [[The Future\|the epilogue]]: The exploration of the [[API]] world is just starting. If you have something to say about [[API]] design and you are not afraid to contribute to a [[Main_Page\|wiki]], feel free to join the [[Main_Page\|wiki.apidesign.org]]. If you have ideas about various [[APITypes]] or [[APIDesignPatterns]] or related topics don't let them be buried in [[Blogs]], put them into [[Main_Page\|wiki]] - [[Main_Page\|wiki]]s are [[Blogs:JaroslavTulach:Theory:DiamondsVsStars\|like stars]], they are forever. Almost.	+	''Update from March 7, 2009:''
		+	:''and really do want the next "Principia". It should have been the''
		+	:''next "Design Patterns" book, something to really love. So admittedly''
		+	:''I had too high of an expectation.''
		+	The later comments made me feel a bit better and the one quoted above reminded me of a story related to [[TheAPIBook\|the book]]'s publication. My publisher's favorite title of the book was '''Definitive Guide to API Design'''. It took me quite a lot arguing and I even needed to meet Apress boss, Dominic, to change their mind. My book can be attributed with various adjectives, but it is not '''definitive''' at all. Take this note to correct your expectations. Don't expect definitive answers to everything related to [[API]] design. Expect that your horizons in the [[API]] world will be enlarged and many things will be more clearly recognizable. But many questions will remain.
		+
		+
		+	I have to repeat the theme of [[The Future\|the epilogue]]: The exploration of the [[API]] world is just starting. If you have something to say about [[API]] design and you are not afraid to contribute to a [[Main_Page\|wiki]], feel free to join the [[Main_Page\|wiki.apidesign.org]]. If you have ideas about various [[APITypes]] or [[APIDesignPatterns]] or related topics don't let them be buried in [[Blogs]], put them into [[Main_Page\|wiki]] - [[Main_Page\|wiki]]s are [[Blogs:JaroslavTulach:Theory:DiamondsVsStars\|like stars]], they are forever. Almost.

JaroslavTulach: New page: I have to mention that I've been pointed to [http://dlinsin.blogspot.com/2009/03/book-review-practical-api-design.html another r... - 2009-03-05 15:10:52

New page: I have to mention that I've been pointed to [http://dlinsin.blogspot.com/2009/03/book-review-practical-api-design.html another r...

New page

I [[Blogs:JaroslavTulach:Daily_Life:YetAnotherAwesomeReview|have to mention]] that I've been pointed to [http://dlinsin.blogspot.com/2009/03/book-review-practical-api-design.html another review] of the [[TheAPIBook|Practical API Design]] book. Very nice read, I was pleased to hear the book was useful. But then, I got to the comments section. Well, that did not feel pleasant anymore. For a while I was searching for a rope and a tree to hung and lynch myself.

However after thinking about it for a bit more, I believe that I do not need to persecute myself for writing [[TheAPIBook|the book]]. I knew the book is not complete, I knew its selection of topics is subjective and related to my own experience (hence the word ''Practical'' in the title), yet the book is still more useful out than kept just in my head and notes.

I just have to repeat the theme of [[The Future|the epilogue]]: The exploration of the [[API]] world is just starting. If you have something to say about [[API]] design and you are not afraid to contribute to a [[Main_Page|wiki]], feel free to join the [[Main_Page|wiki.apidesign.org]]. If you have ideas about various [[APITypes]] or [[APIDesignPatterns]] or related topics don't let them be buried in [[Blogs]], put them into [[Main_Page|wiki]] - [[Main_Page|wiki]]s are [[Blogs:JaroslavTulach:Theory:DiamondsVsStars|like stars]], they are forever. Almost.