Bug 5523 - OpenSolaris 2008.11 Automated Installer Guide docs need restructuring
: OpenSolaris 2008.11 Automated Installer Guide docs need restructuring
Status: RESOLVED FIXED
Product: opensolaris
documentation
: 200811
: ANY/Generic OpenSolaris
: P3 normal (vote)
: in-200906
Assigned To: Barbara Lundquist
:
:
: jsc-qa
:
:
: 5769 5770 5772
  Show dependency treegraph
 
Reported: 2008-12-01 02:34 UTC by Rudolf Kutina
Modified: 2009-03-24 12:20 UTC (History)
4 users (show)

See Also:


Attachments


Note

You need to log in before you can comment on or make changes to this bug.


Description Rudolf Kutina 2008-12-01 02:34:33 UTC
In this stage of AI project is importan then as much as possible users will try
it and generate feedback - t.m. is importan to generate comunity engagement ,
its hard to achive this goal with currrent level of AI docs.

Current document from Nov 17, is full of errors, but this is not major problem
!

Document is rellay hard to follow up mainly because there is wronq document
strucure:

Documetn must be divided into: 

- Intoudction to AI and KEY diffrecnes from JumpStart 
- Setup of AI enviromment with defaults
 - AI env automated setup
 - AI env manual setup (like correct DHCP initializatation)
- Watching AI installation process and debugging 
- Advanced AI usage and configs  

Final imporved document must be revied by real processing of AI install using
selected usage scenarios.
Comment 1 Jan Damborsky 2008-12-03 05:05:38 UTC
Leaving in installer/autoinstall category for time of being and CCing Barbara
until it is decided how those changes in documentation will be managed.
Comment 2 Rudolf Kutina 2008-12-05 06:56:08 UTC
Into default section we must paste information about how AI is wirkng with disk
from AI design document
Comment 3 virginia.wray 2008-12-17 13:39:46 UTC
Reclassifying this as a documentation bug.
Comment 4 Barbara Lundquist 2008-12-19 10:30:39 UTC
I will incorporate this feedback into my next delivery of the AI document. 

Barbara
Comment 5 Barbara Lundquist 2009-03-21 14:03:31 UTC
AI documentation is being restructured and will follow structure similar to
this request. See caiman-discuss@opensolaris.org for latest news and review
copies.
Comment 6 Barbara Lundquist 2009-03-24 12:20:53 UTC
A beta draft of the AI document with substantial doc structural revisions,
along the lines of request below, was delivered to the next engineering build
and to opensolaris.org.