From Gentoo Wiki
Jump to:navigation Jump to:search
This is a talk page. Please add newer comments below older ones, and sign your comments using four tildes (~~~~). When adding a new section (at the bottom of the page), please mark it as "open for discussion" by using {{talk|open}} so it will show up in the list of open discussions.

Installation instructions on wiki (correction implemented)

Talk status
This discussion is done.

While the handbook covers installation, I believe covering it in the wiki better serves installers for several reasons.

  1. Each step of the installation can have its own page
  2. Links can be easily inserted for different build types. For instance, a link for formatting and booting from hard disk, another for RAID setup, and another for SSD format and boot.
  3. Links to external references can also be easily entered.
  4. Screenshots and other pictures can be added.
  5. The installer following a wiki like this can more easily tailor it to their own install and hardware. It should be easier to follow for a basic install, getting a new user up and running more easily, while still providing more advanced information for those installing advanced hardware or configurations.

This series of pages should be organized as a series of steps, one per page, with decision tree links at all points that require them. It should be based on the Gentoo LiveDVD, with links to other installation media and methods (first to Gentoo media, such as the minimal install CD and the USB guide, and then to other distributions if desired). Only the most basic information should go on the core pages. Decisions and advanced information should be linked to separate pages or even outside links (in the case of more advanced information). Core pages should assume a completely inexperienced reader. Advanced pages can assume the reader has more experience. — Serebren 16:01, 1 July 2012 (UTC)

Having installation instructions on the wiki have been discussed a few times in the past. The major issue is that there's little guarantee towards users that the instructions are fool-proof and validated. Whereas the gentoo handbook usually doesn't undergo changes without developer acknowledgement, wiki's are much more difficult to target (and keep clean). Especially with an error-prone installation such as with Gentoo. I don't mind having different installation methods described on the wiki however, but calling them "Installation" might give a user the impression that it is an official one? --SwifT 18:18, 1 July 2012 (UTC)
What about User:SwifT/Installation for this page, and then we can link towards yours as well under the unofficial instructions once it is more complete? --SwifT 18:50, 1 July 2012 (UTC)
I like this one, it looks like a good start. — yngwin 07:17, 2 July 2012 (UTC)
I like your approach, Serebren. Having links to separate pages for specific concerns is a good idea. But I suggest this effort to be merged with the Complete Handbook. Let's not have too much duplication. — yngwin 07:17, 2 July 2012 (UTC)
I copied over the generic installation instruction with references --SwifT 17:56, 3 July 2012 (UTC)

I corrected the link for the Swift Installation page--Regards, Rob 18:30, 3 November 2012 (UTC)