FYI, below is some additional feedback sent to me by Patrick Finch directly. I
will incorporate his changes today along side Prahap's:
HI,
My notes:
First, I love it - looks and reads really well.
Chapter 1
Is there an implicit assumption that user is running Windows? I think that it
isn't a
bad asumption, but that we should make it more explicit, or even flag it "If
you're using
Windows..."
Intro
"Specifically, the three major operating systems in use today, the Solaris?
Operating
System, Linux, and Windows operating systems,"
What about MacOS ? Sounds a little too much like Sun Marketing? We might want
to take
out the definite article here.
OpenSolaris Installation Prerequisites
"The following prerequisites must be met before you can install a laptop with
the
OpenSolaris software using the instructions in this document:"
This is a bit strident, what about "should", instead of "must" ? Generally, we
could make
it seem more optional - be aware that if you don't do this, you lose your data.
To Back Up the Disk Drive
Scan and defragment your disk.
Re-partitioning the Disk Drive
To Re-partition Your Disk
1.Power on the laptop.
2.Choose Control Panel from the Start menu.
3.Double-click the Administrative Tools icon.
4.Double-click the Computer Management icon.
5.Expand the Storage list and select the Disk Management node.
Should say "If you are using Windows" or similar?
Next Steps
If Windows booted successfully, click the Installation tab for further
instructions about
how to install the OpenSolaris software on the new partition.
..what if it doesn't ? ;)
We shouldn't leave the user high and dry. If recommendation is to desist, we
should say
that, or we should direct people to the OpenSolaris laptop community.
Chapter 2. Installing the OpenSolaris Software
Er, this may be a deliberate mistake, but the title seems to say chapter 1, not
chapter 2.
Creating the OpenSolaris Installation Images
We could also suggest "ISO Recorder" for Windows, it's free and works
really well.
Chapter 2
To Install the Solaris Express: Community Release Software
2. Press the Enter key to boot Solaris.
The System Identification screen appears.
1. Specify Yes or No for Network Connectivity.
2. Specify a host name.
3. Specify a time zone.
4. Specify country or region.
5. Specify date and time.
6. Specify root password.
Shouldn't we advise people to set No for Network Connectivity? I'd defer to
Stephen, but
I think this is easier to set up post install than pre. I'd like to know his
thoughts.
I don't think that there is a clear resolution from Troubleshooting to Next
Steps;
troubleshooting would indicate that you revert to Windows, but really, we're
saying either
a. give up or
b. do the install again (?)
Chapter 3 Configuring the OpenSolaris Software
This links seem a bit off, they direct to the wrong places, the Xorg for nVidia
seems to
be in the wrong place, configuring networking went to configuring screen
resolution and
vice versa.
wget - where is this command? which shell do you have to be in to use it?
Patrick
This message posted from opensolaris.org
