Handbook Talk:AMD64/Installation/About

From Gentoo Wiki
Jump to:navigation Jump to:search
Note
Before creating a discussion or leaving a comment, please read about using talk pages. To create a new discussion, click here. Comments on an existing discussion should be signed using ~~~~:
== Discussion title ==

{{Talk|date = 2024-05-13}}

A comment [[User:Larry|Larry]] 13:52, 13 May 2024 (UTC)
: A reply [[User:Sally|Sally]] 23:05, 24 May 2024 (UTC)
:: Your reply ~~~~


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 done as of 2024-04-01.

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)
Looks like this has been done. Waldo Lemmer (talk) 10:53, 1 April 2024 (UTC)

Minor Textual Corrections

Talk status
This discussion is done as of 2024-05-11.

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)

Some nice work here, so thanks a lot! Do see Template:Proposal as a suggestion to help speed up your good work getting merged faster.
Immolo (talk) 21:32, 6 May 2024 (UTC)
Gabe , see this for an example of how it's used. :)
Waldo Lemmer 08:04, 11 May 2024 (UTC)
Fixed in Special:Diff/1272296/1298151, thanks!
--csfore (talk) 18:36, 11 May 2024 (UTC)