Comments regarding the new install instructions have died to nil so I am submitting as is and moving on to my next project. I hope they serve the Gentoo community well.
Created attachment 375 [details] New Install Instructions Zee plane...zee plane!
Do me a favor, if you would, and instead of attaching the entire xml file, just attach a patch? That will make my editing a bit simpler. Thanks!
uhh. should I read this, or deprioritize and focus on something else. It's rc6 era ... drobbins if you think I should drop it, please resolve. sherman
On Fri, 2002-05-03 at 22:07, Michael Lang wrote: > Hi Sherman, > > As far as I know, the installation instructions I wrote never got > incorporated. I spent about two weeks writing them with Semant's > help. The main contribution I made in these documentations was installing > from another distro, which there were a lot of questions being bounced > around on the #gentoo channel about. > > I also took the liberty of reorganizing things based on user feedback so > that multiple paths of installations could be elegantly contained in the > single install documentation. I took out a lot of repetitive notes and > comments and also structured the instructions for installing PCMCIA so that > the instructions flowed better with what the user was actually encountering > as he went through the installation instructions. > > I got a lot of positive feedback and several people were able to > successfully install Gentoo with the new instructions. At least two people > remarked that the new instructions were better in that they didn't have to > figure out steps 1 through 5 (essentially get to the point where they had a > valid Gentoo shell) before they could begin following installation > instructions. > > Why the ball got dropped, I am not sure. Daniel Robbins said that the new > instructions were great and he wanted to see them replace the current > install instructions and asked me to submit them to Bugzilla, which I > did. A week or so goes by and the bug report gets assigned to Grant > somebody who then asks for a patch. I responded directly to him asking him > how to create a patch and never got an answer back. I brought up the fact > that the ball seems to have been dropped on getting the new install > instructions published on the gentoo-dev mailing list two or three times, > but nobody ever responded back or acknowledged that something should be > done, so I gave up the chase and went on to do more important things with > my time. > > Take a look at the instructions. I think you will find the organization is > more elegant and less confusing to the end user and also lends itself to > documenting more than one installation method very well. > > As for helping in the future documentation efforts, I am open to the > possibility, but my time is valuable and I don't want to waste it on > dead-end projects that are just going to sit in Bugzilla. > > Regards, > > Michael
OK, some of this has been integrated into the current document.