Apidesign: /* Daily Life and the Future */ - 2008-06-14 07:00:57

Daily Life and the Future

←Older revision Revision as of 07:00, 14 June 2008
Line 38: Line 38:
Dear Reviewers.
Dear Reviewers.
-
Thanks for your comments in [[ReviewPartII]]. I'll start to process them now. Meanwhile I can offer you part III. I am looking forward to your comments. Please provide them by '''April 23, 2008'''. Btw. do not forget to get latest [[Sources]].
+
Thanks for your comments to Part 2. I'll start to process them now. Meanwhile I can offer you Part 3. I am looking forward to your comments. Please provide them by '''April 23, 2008'''. Btw. do not forget to get latest [[Sources]].

Apidesign: /* Practical Design */ - 2008-06-14 07:00:37

Practical Design

←Older revision Revision as of 07:00, 14 June 2008
Line 17: Line 17:
== Practical Design ==
== Practical Design ==
-
Dear [[Reviewers]] Thanks for your comments in [[ReviewPartI]], now you have a chance to review something real, something that contains a lot examples and also a lot of claims that need to be validated or invalidated.
+
Dear [[Reviewers]] Thanks for your comments to Part 1, now you have a chance to review something real, something that contains a lot examples and also a lot of claims that need to be validated or invalidated.
Keep in mind that grammar changes are not something that I will apply. That is task for my publisher. More than them I am interested in your insight in various technologies that I refer to, but I am not real expert in. If anyone feels there is something about XML, bytecode manipulation, etc. that I do not interpret correctly, please make a note.
Keep in mind that grammar changes are not something that I will apply. That is task for my publisher. More than them I am interested in your insight in various technologies that I refer to, but I am not real expert in. If anyone feels there is something about XML, bytecode manipulation, etc. that I do not interpret correctly, please make a note.

Apidesign: /* Prologue, Theory and Justifications */ - 2008-06-14 06:58:27

Prologue, Theory and Justifications

←Older revision Revision as of 06:58, 14 June 2008
Line 3: Line 3:
Reviews and comments of pre-published versions of the book have been provided by many good reviewers and hopefully helped me eliminate trivial mistakes. I could not address all the comments, that would mean quite a big rewrite of the whole book. I may do it when I write another one, still I believe that the reviewers helped me a lot to make the book a better book.
Reviews and comments of pre-published versions of the book have been provided by many good reviewers and hopefully helped me eliminate trivial mistakes. I could not address all the comments, that would mean quite a big rewrite of the whole book. I may do it when I write another one, still I believe that the reviewers helped me a lot to make the book a better book.
-
== Prologue, Theory and Justifications ==
+
== Theory and Justifications ==
Please read the part and provide your comments here by ''Apr 3, 2008''. Sections prefixed with [[Image:Ok.png]] are already processed. If you modify a section marked as [[Image:Ok.png]], let [[User:JaroslavTulach]] know as I have already processed them and I might overlook your comments.
Please read the part and provide your comments here by ''Apr 3, 2008''. Sections prefixed with [[Image:Ok.png]] are already processed. If you modify a section marked as [[Image:Ok.png]], let [[User:JaroslavTulach]] know as I have already processed them and I might overlook your comments.

Apidesign: /* Prologue, Theory and Justifications */ - 2008-06-14 06:55:26

Prologue, Theory and Justifications

←Older revision Revision as of 06:55, 14 June 2008
Line 9: Line 9:
* [[Image:Ok.png]]Prologue - [[Yet Another Design Book?]]
* [[Image:Ok.png]]Prologue - [[Yet Another Design Book?]]
* [[Image:Ok.png]][[Theory and Justification]]
* [[Image:Ok.png]][[Theory and Justification]]
-
** [[Image:Ok.png]][[The Art of Building Modern Software]]
+
* [[Image:Ok.png]][[The Art of Building Modern Software]]
-
** [[Image:Ok.png]][[The Motivation to Create an API]]
+
* [[Image:Ok.png]][[The Motivation to Create an API]]
-
** [[Image:Ok.png]][[Determining What Makes a Good API]]
+
* [[Image:Ok.png]][[Determining What Makes a Good API]]
-
** [[Image:Ok.png]][[How to Check the Quality of an API]]
+
* [[Image:Ok.png]][[How to Check the Quality of an API]]
-
** [[Image:Ok.png]][[Ever Changing Targets]]
+
* [[Image:Ok.png]][[Ever Changing Targets]]
== Practical Design ==
== Practical Design ==

Apidesign at 06:54, 14 June 2008 - 2008-06-14 06:54:39

←Older revision Revision as of 06:54, 14 June 2008
Line 1: Line 1:
== Reviewers ==
== Reviewers ==
-
Reviews and comments of pre-published versions of the book have been provided by many good reviewers and hopefully helped me eliminate trivial mistakes and make the book a better book:
+
Reviews and comments of pre-published versions of the book have been provided by many good reviewers and hopefully helped me eliminate trivial mistakes. I could not address all the comments, that would mean quite a big rewrite of the whole book. I may do it when I write another one, still I believe that the reviewers helped me a lot to make the book a better book.
-
#INCLUDE [[Reviewers:PartI]]
+
== Prologue, Theory and Justifications ==
-
* [[Reviewers:PartII]]
+
-
* [[Reviewers:PartIII]]
+
-
and summary by people who had to dig through it:
+
Please read the part and provide your comments here by ''Apr 3, 2008''. Sections prefixed with [[Image:Ok.png]] are already processed. If you modify a section marked as [[Image:Ok.png]], let [[User:JaroslavTulach]] know as I have already processed them and I might overlook your comments.
-
* [[Reviewers:TomWheelerNotes]]
+
* [[Image:Ok.png]]Prologue - [[Yet Another Design Book?]]
-
* [[Reviewers:RichUngerNotes]]
+
* [[Image:Ok.png]][[Theory and Justification]]
-
* [[Reviewers:MartinRinardNotes]]
+
** [[Image:Ok.png]][[The Art of Building Modern Software]]
-
* [[Reviewers:AdamDingleNotes]]
+
** [[Image:Ok.png]][[The Motivation to Create an API]]
 +
** [[Image:Ok.png]][[Determining What Makes a Good API]]
 +
** [[Image:Ok.png]][[How to Check the Quality of an API]]
 +
** [[Image:Ok.png]][[Ever Changing Targets]]
 +
 
 +
== Practical Design ==
 +
 
 +
Dear [[Reviewers]] Thanks for your comments in [[ReviewPartI]], now you have a chance to review something real, something that contains a lot examples and also a lot of claims that need to be validated or invalidated.
 +
 
 +
Keep in mind that grammar changes are not something that I will apply. That is task for my publisher. More than them I am interested in your insight in various technologies that I refer to, but I am not real expert in. If anyone feels there is something about XML, bytecode manipulation, etc. that I do not interpret correctly, please make a note.
 +
 
 +
Another thing that I'd like you to verify is how easy it is to work with [[Sources]]. Are they connected well with the text of the book? Do you know what to do with them? Can you run them, study the sources, debug them? Is there any aspect that they miss and that should be improved? It is especially important to identify things that need to be done before publishing the book, those others can simply be improved later.
 +
 
 +
Finish your review by '''Apr 14, 2008''' please. Little delay is ok, but the sooner the better:
 +
 
 +
* [[Image:Ok.png]][[Do Not Expose More Than You Want]]
 +
* [[Image:Ok.png]][[Code Against Interfaces, Not Implementations]]
 +
* [[Image:Ok.png]][[Use Modular Architecture]]
 +
* [[Image:Ok.png]][[Separate APIs for Client APIs and Support APIs]]
 +
* [[Image:Ok.png]][[Keep Testability In Mind]]
 +
* [[Image:Ok.png]][[Cooperating with Other APIs]]
 +
* [[Image:Ok.png]][[Runtime Aspects of APIs]]
 +
* [[Image:Ok.png]][[Declarative Programming]]
 +
 
 +
== Daily Life and the Future ==
 +
 
 +
Dear Reviewers.
 +
 +
Thanks for your comments in [[ReviewPartII]]. I'll start to process them now. Meanwhile I can offer you part III. I am looking forward to your comments. Please provide them by '''April 23, 2008'''. Btw. do not forget to get latest [[Sources]].
 +
 
 +
 
 +
* [[Image:Ok.png]][[Extreme Advice Considered Harmful]]
 +
* [[Image:Ok.png]][[Paradoxes of API Design]]
 +
* [[Image:Ok.png]][[Evolving the API Universe]]
 +
* [[Image:Ok.png]][[Teamwork]]
 +
* [[Image:Ok.png]][[Using Games to Improve API Design Skills]]
 +
* [[Image:Ok.png]][[Case Study of Writing the Extensible Visitor Pattern]]
 +
* [[Image:Ok.png]][[End Of Life Procedures]]
 +
* [[Image:Ok.png]]Epilogue - [[The Future]]

Apidesign: /* Reviewers */ - 2008-06-14 06:51:43

Reviewers

←Older revision Revision as of 06:51, 14 June 2008
Line 1: Line 1:
== Reviewers ==
== Reviewers ==
-
Reviews of pre-published versions of the book:
+
Reviews and comments of pre-published versions of the book have been provided by many good reviewers and hopefully helped me eliminate trivial mistakes and make the book a better book:
-
* [[Reviewers:PartI]]
+
#INCLUDE [[Reviewers:PartI]]
* [[Reviewers:PartII]]
* [[Reviewers:PartII]]
* [[Reviewers:PartIII]]
* [[Reviewers:PartIII]]

Apidesign: /* Reviewers */ - 2008-06-14 06:17:17

Reviewers

←Older revision Revision as of 06:17, 14 June 2008
Line 1: Line 1:
== Reviewers ==
== Reviewers ==
-
Non public comments from the [[ThanksEveryone|reviewers]]
+
Reviews of pre-published versions of the book:
-
 
+
-
* [[Reviewers:TomWheelerNotes]]
+
-
* [[Reviewers:RichUngerNotes]]
+
-
* [[Reviewers:MartinRinardNotes]]
+
-
 
+
-
Reviews of pre published versions of the book:
+
* [[Reviewers:PartI]]
* [[Reviewers:PartI]]
* [[Reviewers:PartII]]
* [[Reviewers:PartII]]
* [[Reviewers:PartIII]]
* [[Reviewers:PartIII]]
 +
 +
and summary by people who had to dig through it:
 +
 +
* [[Reviewers:TomWheelerNotes]]
 +
* [[Reviewers:RichUngerNotes]]
 +
* [[Reviewers:MartinRinardNotes]]
 +
* [[Reviewers:AdamDingleNotes]]

Apidesign: Protected "Reviewers" [edit=sysop:move=sysop] [cascading] - 2008-06-13 21:57:36

Protected "Reviewers" [edit=sysop:move=sysop] [cascading]

←Older revision Revision as of 21:57, 13 June 2008

Apidesign at 21:51, 13 June 2008 - 2008-06-13 21:51:56

←Older revision Revision as of 21:51, 13 June 2008
Line 6: Line 6:
* [[Reviewers:RichUngerNotes]]
* [[Reviewers:RichUngerNotes]]
* [[Reviewers:MartinRinardNotes]]
* [[Reviewers:MartinRinardNotes]]
 +
 +
Reviews of pre published versions of the book:
 +
 +
* [[Reviewers:PartI]]
 +
* [[Reviewers:PartII]]
 +
* [[Reviewers:PartIII]]

Apidesign at 21:46, 13 June 2008 - 2008-06-13 21:46:12

←Older revision Revision as of 21:46, 13 June 2008
Line 3: Line 3:
Non public comments from the [[ThanksEveryone|reviewers]]
Non public comments from the [[ThanksEveryone|reviewers]]
-
* [[Reviewers:TomWhelerNotes]]
+
* [[Reviewers:TomWheelerNotes]]
* [[Reviewers:RichUngerNotes]]
* [[Reviewers:RichUngerNotes]]
* [[Reviewers:MartinRinardNotes]]
* [[Reviewers:MartinRinardNotes]]