[arch-releng] Official Arch Linux Install Guide changes caused by 2009.08

[Dieter Plaetinck]

On Thu, 23 Jul 2009 15:01:37 -0400
Loui Chang <louipc.ist at gmail.com> wrote:

> On Thu 23 Jul 2009 20:06 +0200, Dieter Plaetinck wrote:
> > Hi all,
> > the Official Arch Linux Install Guide ( http://wiki.archlinux.org/index.php/Official_Arch_Linux_Install_Guide )
> > will need to be changed in various places because 2009.08 will use AIF and no longer archlinux-installer, which differ in various aspects.
> > 
> > There are the IMHO following requirements:
> > - current content should not be tampered with, so people who install 2009.02 now or in a few weeks have the correct guide
> > - also after 2009.08 is released, the current guide should probably stay available (maybe under a different name "deprecated"?) for users who still use older discs
> > - by the time 2009.08 is out, the documentation must match it, so we should start working on new documenation now.
> > 
> > 
> > What I suggest is:
> > - to copy the current page to a "new guide". the new guide gets a note it's only valid for 2009.08 and onwards. the current guide gets a note that says it's only valid until 2009.02
> > - when 2009.08 is released, I would rename the current page to add "deprecated" or "old" to it.  and put the new guide in it's place.
> >   (afaik you can't rename pages in wiki's so basically it would mean "copy paste all content to the other")
> > 
> > I know AIF best so I would take the lead in doing (most of) the required documentation changes.
> > 
> > 1) Is this a good proposal?
> 
> Not bad, but I think the wiki should be dropped. People should be
> advised to consult the docs that come with the CD. If you make a change
> in the installer, then you can update the docs alongside it rather than
> having to worry about syncing with the wiki or whatever.
> 
> > 3) I currently have no write access to the install guide (I seem to have no administrator privileges).
> > 4) What would be the best practice for me getting started on the new
> > content, allowing others to contribute but not to ruin my work?  Lock
> > the new page and have people email me with corrections?
> 
> Use Git!
> 

actually that sounds good.  The only thing the wiki would be better at is "easyness of feedback" from users.
But a note at the end explaining you can send feedback to this list or my personal email adress would make up for that.

And then we also need to render a html version of this online (say what you want, but an online version can be useful),
but I guess we can solve that problem by using markdown markup in the textfile (which is very unobtrusive in plaintext and transforms into html quite well)

and we can make the installation guide available in /usr/share/arch (?) very easily!

Dieter