←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]] |