Hello Barbara,

 My feedback pertains only to the "Getting Started Guide".

Barbara.Lundquist at Sun.COM wrote:
> 1) Getting Started With OpenSolaris 2008.11 at
> http://www.opensolaris.org/os/project/caiman/files/getstart.pdf
>
> Changes in Getting Started With OpenSolaris 2008.11:
> - Please check blog links to see if any are outdated.
> - I added a New Features section with Auto Install and Distro 
>  Constructor descriptions.  
> - I moved the Upgrade section into this book.
> - The IPS sections are moved to a separate book that will be reviewed
>  next week.
> - The Snap Upgrade section was moved to a separate book per below.
> - Rearranged some sections and rewrote for clarity.
> - Basic installation procedures are largely unchanged.
> - Some of the doc cross-references still point to 2008.05 docs

The document should consist of 3 chapters:

1) Getting Started with... (Pages 5-11)
2) Installing OpenSolaris 2008.11 (Pages 11-21)
3) Installing OpenSolaris 2008.11 as a Virtual Machine (Pages 22-29)

Several sections need to be shifted or consolidated, such as:

* Chapter 1's flow should be more introductory... why should the user
both using this release?  "Overview of OpenSolaris..." should be the
first section.
* "Installation Roadmap" should be pushed to first section of Chapter 2
* "System Requirements" should preceed "Limitation for the ..." in
Chapter 1.
* "New Features in OpenSolaris 2008.11" should be the first section of
"Overview of OpenSolaris 2008.11".
* In general, I'm tempted to say that the other sections of the
"Overview of OpenSolaris 2008.11" should be dumped or moved. 
* Is there a "Whats New in 2008.11" separate document?

* I'm not sure we need installation instructure for installing
Virtualbox on so many platforms.... just seems patronizing.
* We discuss Virtualbox and Parallel's... we should therefore also add
VMWare Workstation/Fusion and potentially (maybe not for this release)
Xen/xVM.
* There should be a "Consideration when Installing ..." section.

benr.

Reply via email to