Showing messages 1 through 3 of 3.

• Constructive criticism
  2004-08-10 05:46:30 morten
  
  Hi. I'm sure the entire community appreciates this effort (as do I). But have you (or your editor) asked yourselves who your target audience is?
  
  1. Surely people wishing to install a pre-1.0 release of a full blown J2EE app server can deal with a GERONIMO_HOME env variable/abstract. So drop the "ha-ha #2 pencil" comments and skip the "tada-bing.wav" jokes. Would they do anything for you if you had bought this book?
  
  2. It's a technical text - make it brief and to the point, if there's nothing to write - don't. Example, the CVS section:
  

  
  Like most open source projects, Geronimo uses CVS as its code repository. CVS stands for Concurrent Version System in case you were wondering. If you were, then you should take a moment and visit www.cvshome.org to get yourself familiar with the tool. CVS is older that the hills in terms of open source software, so we are going to assume basic CVS knowledge in this section.
  

  
  Don't start from Adam and Eve each time. People reading this book know what CVS is - and if not, writing ".. CVS (See www.cvshome.org for more).." is all you/whoever need.
  
  3. I do like the way you divide the book into subsections.

• I love the section titles
  2004-08-09 16:24:17 swaptions
  
  I love the section titles, "What just happened?" and "Why do I care?"
  
  Is the use of the color red an artifact of the publishing process? It's a bit jarring.
  
  Is there an extended table of contents to peek at?
• I love the section titles
  2004-08-09 09:48:35 dblevins
  
  The red color and all the other colors are just part of the book template. Had the chapters gone through the full production process the PDFs would be black and white with much better type setting, etc. The book will look just like the rest of the Developer's Notebooks:
  
  http://devnotebooks.oreilly.com/
  
  The outline has changed several times and will continue to do so till Geronimo and the book are closer to completion. The fundamental vision for the book is to cover the steps required to use/deploy/manage Web components, EJB components, Connectors, Transactions and Security.