From dieter@plaetinck.be Thu Jul 23 14:06:23 2009 From: Dieter Plaetinck To: arch-releng@lists.archlinux.org Subject: [arch-releng] Official Arch Linux Install Guide changes caused by 2009.08 Date: Thu, 23 Jul 2009 20:06:19 +0200 Message-ID: <20090723200619.6271b631@plaetinck.be> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============2323954025920470659==" --===============2323954025920470659== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hi all, the Official Arch Linux Install Guide ( http://wiki.archlinux.org/index.php/O= fficial_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 avai= lable (maybe under a different name "deprecated"?) for users who still use ol= der discs - by the time 2009.08 is out, the documentation must match it, so we should s= tart 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 o= nly 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 "deprecate= d" 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 pa= ste all content to the other") I know AIF best so I would take the lead in doing (most of) the required docu= mentation 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 a= dministrator 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 an= d have people email me with corrections? Dieter --===============2323954025920470659==-- From snd.noise@gmail.com Thu Jul 23 14:50:01 2009 From: farid abdelnour To: arch-releng@lists.archlinux.org Subject: Re: [arch-releng] Official Arch Linux Install Guide changes caused by 2009.08 Date: Thu, 23 Jul 2009 15:49:40 -0300 Message-ID: <3037e6060907231149y4ade9f1dp48b8e8f4f89bdc86@mail.gmail.com> In-Reply-To: <20090723200619.6271b631@plaetinck.be> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============8453024670042830826==" --===============8453024670042830826== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit > > 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 atelier-labs rede mocambos GNU archlinux brasil --===============8453024670042830826==-- From raulgrell@gmail.com Thu Jul 23 14:50:42 2009 From: Raul Leal To: arch-releng@lists.archlinux.org Subject: Re: [arch-releng] Official Arch Linux Install Guide changes caused by 2009.08 Date: Thu, 23 Jul 2009 19:50:20 +0100 Message-ID: In-Reply-To: <20090723200619.6271b631@plaetinck.be> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============5248765682571918964==" --===============5248765682571918964== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable 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 wrot= e: > 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 > --===============5248765682571918964==-- From louipc.ist@gmail.com Thu Jul 23 15:03:35 2009 From: Loui Chang To: arch-releng@lists.archlinux.org Subject: Re: [arch-releng] Official Arch Linux Install Guide changes caused by 2009.08 Date: Thu, 23 Jul 2009 15:01:37 -0400 Message-ID: <20090723190137.GB5788@lynn> In-Reply-To: <20090723200619.6271b631@plaetinck.be> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============4033486520202230637==" --===============4033486520202230637== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable 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. >=20 > There are the IMHO following requirements: > - current content should not be tampered with, so people who install 2009.0= 2 now or in a few weeks have the correct guide > - also after 2009.08 is released, the current guide should probably stay av= ailable (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. >=20 >=20 > 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 "depreca= ted" 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") >=20 > I know AIF best so I would take the lead in doing (most of) the required do= cumentation changes. >=20 > 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! --===============4033486520202230637==-- From dieter@plaetinck.be Thu Jul 23 15:22:02 2009 From: Dieter Plaetinck To: arch-releng@lists.archlinux.org Subject: Re: [arch-releng] Official Arch Linux Install Guide changes caused by 2009.08 Date: Thu, 23 Jul 2009 21:21:56 +0200 Message-ID: <20090723212156.7cf05607@plaetinck.be> In-Reply-To: <20090723190137.GB5788@lynn> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============8105202044380103109==" --===============8105202044380103109== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable On Thu, 23 Jul 2009 15:01:37 -0400 Loui Chang 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.p= hp/Official_Arch_Linux_Install_Guide ) > > will need to be changed in various places because 2009.08 will use AIF an= d no longer archlinux-installer, which differ in various aspects. > >=20 > > 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 us= e older discs > > - by the time 2009.08 is out, the documentation must match it, so we shou= ld start working on new documenation now. > >=20 > >=20 > > 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 say= s it's only valid until 2009.02 > > - when 2009.08 is released, I would rename the current page to add "depre= cated" 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 "cop= y paste all content to the other") > >=20 > > I know AIF best so I would take the lead in doing (most of) the required = documentation changes. > >=20 > > 1) Is this a good proposal? >=20 > 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. >=20 > > 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? >=20 > Use Git! >=20 actually that sounds good. The only thing the wiki would be better at is "ea= syness of feedback" from users. But a note at the end explaining you can send feedback to this list or my per= sonal email adress would make up for that. And then we also need to render a html version of this online (say what you w= ant, but an online version can be useful), but I guess we can solve that problem by using markdown markup in the textfil= e (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 --===============8105202044380103109==--