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
