Barbara,
Sorry for getting back to you late on this request. Can we start the
discussion in AI meeting tomorrow and figure out what type of
documentation we need and when do you need information and documentation
reviews be done?
Thanks,
Sundar
Barbara.Lundquist at sun.com wrote:
> To all Auto Installers,
>
> Let's start a team discussion about what Automated Installer
> documentation we want to provide for the next (June) OpenSolaris
> release. I'll facilitate this email discussion. Please send your
> thoughts to caiman-discuss and cc docs-discuss by replying to this
> email. Let's try to finish covering our primary discussion points over
> the next two weeks.
> Barbara
>
> 2008.11 Documents
> ===============
> 1) OpenSolaris 2008.11 Automated Installer Guide (main HTML copy)
> http://dlc.sun.com/osol/docs/content/2008.11/AIinstall/
>
> For a .pdf "discussion copy", see
> http://www.opensolaris.org/os/project/indiana/files/AIinstall.pdf
>
> 2) installadm(1M) man page "discussion copy", see
>
> http://www.opensolaris.org/os/project/indiana/files/installadm.1m.txt
>
>
> Major Discussion Points for June Release
> =============================
> The following major discussion points have been made so far:
>
> 1) Restructure AI article per bugs 5772 and 5773, and per discussions
> at Eric's staff meetings last week:
>
> * Provide a very basic scenario first.
> This basic scenario will be based on some engineering AI redesigns
> planned for June release which will provide this basic scenario.
> (See revised AI design document in process.)
>
> * Separate out the troubleshooting into a later section in the article.
>
> * Separate more advanced AI scenarios into a later section in the
> article.
>
> 2) Provide separate FAQ section, either in the AI article, or
> elsewhere (on a wiki?).
>
> 3) Barbara owns the AI article and man page. Do we need additional
> owners for other new documentation, such as FAQ wiki?
>
> 4) We plan to leave the AI article in the mercurial repository as XML
> document that delivers in HTML for June release. Possibly change this
> article to wiki document after the next release.
>
>
> AI Doc Bug Fixes for Reference
> =======================
> #5772, #5523 Restructure article for basic scenario first...
> #6052, #6054, #6262 Remove internal and /tmp file references in
> article and man page
> #6053 Complete network access documentation to provide netmask
> information
> #5800, #5759 Explain how to test AI in current network environments,
> given AI network/DHCP server requirements
> #5770 Need consistent XML usage in AI/DC documentation, such as in the
> manifest examples
> #5553, #5051 Correct errors in man page (required/optional parameters,
> unclear source image)
> #5758 Explain how to delete existing AI services and environments
> #6442 Clarify create-client can accept multiple property-value pairs
>
>
>
>
>
> _______________________________________________
> caiman-discuss mailing list
> caiman-discuss at opensolaris.org
> http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
