| 1 |
On Wed, Mar 03, 2004 at 12:15:38PM -0500, Brad Laue wrote: |
| 2 |
> I'm concerned that the new guide, which covers not only x86 but all |
| 3 |
> architectures in a massive document is not going to be helpful for a |
| 4 |
> relatively new user who just wants to get it installed on their PowerMac |
| 5 |
> or their new Pentium 4. Commentary is a good thing, and inclusion of |
| 6 |
> instructions for all architectures is slick, but I think it needs to be |
| 7 |
> moderated slightly. |
| 8 |
> |
| 9 |
> For example, clever use of XML can allow us to write an entire |
| 10 |
> installation guide for all architectures in one common base of |
| 11 |
> documents, and then can allow us to selectively generate a guide for x86 |
| 12 |
> or SPARC on the fly. This would keep maintenance hassle to the same |
| 13 |
> minimum it's at now, and would make installation instructions much |
| 14 |
> clearer for the new reader (instead of reading and skipping, reading and |
| 15 |
> skipping, and hoping he/she hasn't gone too far). |
| 16 |
|
| 17 |
It's on the GDP TODO list: |
| 18 |
http://www.gentoo.org/proj/en/gdp/roadmap.xml#doc_chap1_sect6 |
| 19 |
|
| 20 |
The requirements are known: |
| 21 |
http://article.gmane.org/gmane.linux.gentoo.documentation/1055 |
| 22 |
|
| 23 |
If you want to take it on: |
| 24 |
http://bugs.gentoo.org/show_bug.cgi?id=42823 |
| 25 |
|
| 26 |
> Finally, I think the multi-page version is a good document to keep |
| 27 |
> around. It's great on the website as it expands upon the installation |
| 28 |
> process and how it works, and what's good/bad about various options, |
| 29 |
> which keeps people informed. But at the very least, is it possible to |
| 30 |
> consider placing a condensed set of installation instructions similar to |
| 31 |
> those present back in the day of 1.2 on the CD's themselves? |
| 32 |
|
| 33 |
We have a quick installation guide but it is unmaintained currently and |
| 34 |
therefor unlinked from the main page: |
| 35 |
http://www.gentoo.org/doc/en/gentoo-x86-quickinstall.xml |
| 36 |
|
| 37 |
Analogue guides can be created for the individual architectures. |
| 38 |
|
| 39 |
Wkr, |
| 40 |
Sven Vermeulen |
| 41 |
|
| 42 |
-- |
| 43 |
^__^ And Larry saw that it was Good. |
| 44 |
(oo) Sven Vermeulen |
| 45 |
(__) http://www.gentoo.org Documentation & PR |
Archives