Hi Pradhap, Thanks again for your participation in this review, find inline below responses marked with [mo] to your changes, and some follow-up questions if you can spare time to help me some more.
Couple of things which I had noted down * In the prequsite list it would good be, if we explicitly mention that Solaris requires a primary partition for installation. Because people try to install Solaris on multiboot machine half-way through they recognize that Solaris requires a primary partition so they have to start all over again which is bad. [mo]Good point, I've added this information to the prerequisites section. * In the re-partition section http://www.opensolaris.org/os/community/documentation/reviews/chapter1/ch01s03.html - I d'nt see why we need the steps 1-5. Is it just to know the current parition layout ?? [mo]Agreed, I've tried to clarify this by adding some additional text that explains the reason for these steps and creating substeps. - In the step 6, It would be better if we mention that burn the system-rescuecd iso image and reboot the system. Ask user to make sure that (CD/DVD)rom is first boot device so that it boots up with system-rescudecd. [mo]OK, thanks for this detail, I've split this into separate steps for burning, and rebooting to help make this more clear. Let me know if the text makes sense: "Set the CD/DVD-Rom drive to be the first boot device, and reboot the system." [mo]Is this enough information? - Also we need to emphasize the repartition section aim is to create a free Primary partition. [mo]Agreed, I've added this to the task summary section to make it more visible. - The link "Home" in end of the page is broken points to wrong location. And the next link is blank it would good if it points to "Installing the OpenSolaris Software " [mo]Right, the navigation will be different in the final kit, so these will change or be fixed at final delivery. Sorry for the inconvenience, I definitely traded time for pretty on this review... and I'd do it again ;) * In the Installing the OpenSolaris Software section http://www.opensolaris.org/os/community/documentation/reviews/chapter2/ - There are lots of typo "i install" this section need to replace those - Link "Home" at the bottom of the page is pointing to a wrong location - It would be better to have "Next" link [mo]I assume you are making the point that 'i' should be capitalized? i install is the name of the second DVD in the kit, so I will give this feedback to the rest of the team, because I need to be consistent with the naming...at least it doesn't have Java in there :) It might be too late to change that naming at this point, but it is good feedback for future revisions. * In "Configuring Xorg for nVidia for Solaris" section http://www.opensolaris.org/os/community/documentation/reviews/chapter3/ - It says "configuring wireless networking" which is not related to this section. [mo] Good catch, fixed. - It would be better to add a trouble shooting tip:- Sometime after the installation of Solaris at first boot, if Xorg/Xsun not configured properly dtlogin goes for a toss so user need to reboot the machine with "-s" option from grub to land into "Single user" mode and then start installation. [mo]I don't understand this change. Do you want me to note this after the installation procedure, or as a prerequisite to configuring Xorg? I think you are trying to say here that, if xorg is not configured properly, you'll know it because dtlogin doesn't work. If this is the case, you need to reboot -s from the grub menu to log in. Am I close? Then, the user can do the Xorg configuration? I'm confused by your 'then start installation' comment at the end. Sorry to be dense, I appreciate your help here. * In "Configuring Networking" section http://www.opensolaris.org/os/community/documentation/reviews/chapter3/ch01s03.html - It would be good to add links for Ginetmenu and Netprof for wireless. [mo] I've added a link to the inetmenu page of the laptop community, I found some info on netprof, but nothing that would make a good link target, any more detail you can provide would be great. - For ethernet card if user need to change the IP address/Hostname he has no clue where to start. So it would be better to add "sys-unconfig" command so that users need to runs and reboot the machine for setting it up. [mo]OK, I've added a section that refers to this man page at the end of the procedure, but I'm not sure if this is what you intended or if it is enough. Let me know, thanks again for your time and excellent feedback! Regards, Michelle This message posted from opensolaris.org
