[arch-releng] Official Arch Linux Install Guide changes caused by 2009.08
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? 2) I can't do any of the other languages, could translators pitch in? 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? Dieter
1) Is this a good proposal? 2) I can't do any of the other languages, could translators pitch in?
i will try to organize the archlinux brazil team to translate to portuguese 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?
Dieter
-- 1111.1010.r.i.1101|n.o.i.s.1110|i.m.1010.g.1110|مقاومة fsf member #5439 usuario GNU/Linux #471966 <a href="www.atelier-labs.org">atelier-labs</a> <a href="www.mocambos.net">rede mocambos</a> <a href="http://www.gnu.org">GNU</a> <a href="www.archlinux-br.org">archlinux brasil</a>
1) Proposal looks good
2) I'm available for translating it to Portuguese, if you need me.
3) Can't help there...
4) How about http://approver.com/, http://www.writeboard.com/, or maybe even
google docs...
On Thu, Jul 23, 2009 at 7:06 PM, Dieter Plaetinck
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? 2) I can't do any of the other languages, could translators pitch in? 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?
Dieter
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!
On Thu, 23 Jul 2009 15:01:37 -0400
Loui Chang
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
participants (4)
-
Dieter Plaetinck
-
farid abdelnour
-
Loui Chang
-
Raul Leal