Handbook Talk:AMD64/Installation/About

From Gentoo Wiki
Jump to:navigation Jump to:search
Note
This is a Talk page - please see the documentation about using talk pages. Add newer comments below older ones, sign comments using four tildes (~~~~), and indent successive comments with colons (:). Add new sections at the bottom of the page, under a heading (== ==). Please remember to mark sections as "open for discussion" using {{talk|open}}, so they will show up in the list of open discussions.


CSS margin-bottom bugs

Talk status
This discussion is still ongoing as of September 8, 2017.

Table elements don't have margin-bottom, but they are listed with p elements. So they should have the same margin-bottom p elements have. This value is 10px.

The note in this page is characterized by class ".alert" and it has 20px to margin-bottom. For coherence the value should be 10px as table or p element. --Suricata (talk) 20:07, 8 September 2017 (UTC)

Knoppix

Talk status
This discussion is done.

There's a reference to Knoppix in the text of this article. We can add a link as well (https://www.knopper.net/knoppix/). Fturco (talk) 17:06, 22 November 2018 (UTC)

I moved this discussion here. Fturco (talk) 16:50, 14 April 2020 (UTC)

Suggestions for Improvement

Talk status
This discussion is done as of 17 July, 2020.

I'm back, with more suggestions. Quoted material is from the article "About the Gentoo Linux Installation".


"If anyone believes otherwise, please bug report it."

A bug report is an object, not an action. "If anyone believes otherwise, please file a bug report"


"4 -- The installation environment is prepared and the user is ready to chroot into the new environment."

The verbiage is fine, but "chroot" is probably not a familiar term for the target audience. Insert a wikilink:

4 -- The installation environment is prepared and the user is ready to chroot into the new environment.


"7 -- The user will have configured most of the Gentoo system configuration files."

All the rest of the items in the list are in the present tense, or the present perfect tense. I suggest ditching the future tense here and dropping the lead-in (for consistency of style); also, use a different verb, to avoid redundancy.

7 -- Most of the Gentoo system configuration files are created.


"It is however what Gentoo believes most users will use."

Bad punctuation. Believe it or not, good writers still use commas. It is, however, what Gentoo believes most users will use.

(You should also avoid locutions like "users will use" and "configure the configuration file". They are redundant and trite. Better would be "It is, however, the choice that Gentoo believes most users will make.")


"We also provide a Gentoo installation tips and tricks document that might be useful to read as well."

Brevity is the soul of wit. Drop the superfluous verbiage: We also provide a Gentoo installation tips and tricks document that might be useful.


"Note though that, although this document is architecture-specific, it might contain references to other architectures as well. This is due to the fact that large parts of the Gentoo Handbook use installation source text that is shared for all architectures (to avoid duplication of efforts and starvation of development resources). We will try to keep this to a minimum to avoid confusion."

Verbose, and a bit confusing. It also contains first person language, which we are exhorted to eschew. I suggest:

Although this document is architecture-specific, it may contain references to other architectures as well, because large parts of the Gentoo Handbook use text that is identical for all architectures (to avoid duplication of effort). Such references have been kept to a minimum, to avoid confusion.


That's it. On to the next chapter! --Davidbryant (talk) 15:24, 17 July 2020 (UTC)

Changed. Thanks for the suggestions --Grknight (talk) 16:33, 17 July 2020 (UTC)

Bugday 2021-02-06 - possible improvements

Talk status
This discussion is done as of February 9, 2021.

In section Installation options for Gentoo there are DVDs mentioned. However, there are no longer any DVDs available for any arch, hence I suggest to remove DVD from the text

Waebbl (talk) 15:12, 6 February 2021 (UTC)

This section has been reworded. See this diff. Thank you for reporting! --Maffblaster (talk) 00:35, 10 February 2021 (UTC)

Boot CD options

Talk status
This discussion is still ongoing.

There is a section on installation from non-Gentoo LiveCDs in the installation alternatives article. Might it not be a good idea to link to that section from installation options for Gentoo, where this is mentioned, so that the important details of that method can be found by anyone wanting to do this? -- Ris (talk) 10:41, 13 March 2023 (UTC)

Note also the section Installation alternatives#Installing Gentoo from an existing Linux distribution. -- Ris (talk) 15:32, 14 March 2023 (UTC)

Minor Textual Corrections

Talk status
This discussion is still ongoing.

Below are two minor textual corrections on what I believe to be typos in the Handbook:AMD64/Installation/About page:

  • Under the Handbook:AMD64/Installation/About#Power, the last sentence in the first paragraph reads "This strength surfaces another Gentoo design principal: power.". I believe that where it reads "principal" it should be "principle" instead.
  • Still under Handbook:AMD64/Installation/About#Power, the last paragraph reads "It is very important that the Handbook reader understands that these design principals are what makes Gentoo unique. With the principals of great power, many choices, and extreme openness highlighted, (...)". I again believe both occurrences of "principals" should actually read "principles".

Gabe (talk) 04:35, 4 March 2024 (UTC)