Hi Sundar,
It had been suggested that the split was unclear due to the matrix
that results in splitting out. Is it an X86 server and X86 client, X86
server and SPARC client, SPARC server and X86 client, SPARC server and
SPARC client?
The extra text makes the instructions far more daunting (~400
lines more text).
Lastly, this makes it more clear what's necessary from a high
level overview for setting up an AI server down to the mechanics. (Versus
getting only the mechanics if there's a less concise presentation.)
Perhaps we could produce a set of instructions only (since the
actual steps are the same) and then two sections showing only output. Then
the user can go to just the section which interests them?
Thank you,
Clay
On Thu, 5 Feb 2009, Sundar Yamunachari wrote:
> Clay Baenziger wrote:
>> Hi all,
>> I don't think I've seen a code review request for the AI HTML files
>> in the caiman-docs gate ever before, however, Sundar pointed out these
>> files are getting a bunch more eyes (and I failed to do enough due
>> diligence in a recent update missing a few key points). So, let's do
>> code-review for these, starting, well now...
>> Could I get a a set of eyes or two to tell me if everything looks
>> good and accurate, or what doesn't read right in the files at:
>>
>> Original:
>> http://www.opensolaris.org/os/project/caiman/auto_install/AI_install_server_setup.html
>> Webrev:
>> http://cr.opensolaris.org/~clayb/6420/webrev/
>> Bug:
>> http://defect.opensolaris.org/bz/show_bug.cgi?id=6420
>>
>> Thank you,
>> Clay
>> _______________________________________________
>> caiman-discuss mailing list
>> caiman-discuss at opensolaris.org
>> http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
>>
> Clay,
>
> Why do you have to combine the X86 and SPARC setup instructions in to one
> set of instructions? Is there any request that there should be only one
> section that contains both X86 and SPARC setup? Even though the setup
> instructions are similar, the output is different. Putting them in the same
> section will be more confusing. I want documentation to be clear even if
> involves duplication of steps.
>
> Thanks,
> Sundar
>
