Handbook Talk:AMD64/Installation/About
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
~~~~:
A comment [[User:Larry|Larry]] 13:52, 13 May 2024 (UTC) : A reply [[User:Sally|Sally]] 08:24, 5 November 2024 (UTC) :: Your reply ~~~~
Suggestions for Improvement
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)
Bugday 2021-02-06 - possible improvements
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
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
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.
- Gabe , see this for an example of how it's used. :)
- — Waldo Lemmer 08:04, 11 May 2024 (UTC)
- Immolo (Immolo) , Waldo Lemmer (Waldo Lemmer) , thanks for highlighting the Template:Proposal template along with usage sample, I was completely oblivious to it. Appreciate the feedback, friends. :) Gabe (talk) 04:13, 10 June 2024 (UTC)
- Fixed in Special:Diff/1272296/1298151, thanks!
- --csfore (talk) 18:36, 11 May 2024 (UTC)
Gentoo's OpenRC
This page still list OpenRC as it's own, is this still the case?
Immolo (talk) 08:43, 21 September 2024 (UTC)
Adding new ebuild's to Gentoo
Under choices the handbook still recommends opening a bug to add to Gentoo, however Gentoo now ask user's to submit to GURU first so this should be updated to match.
Immolo (talk) 08:47, 21 September 2024 (UTC)
- Fixed in Special:Diff/1314053/1316760, thanks!
- --csfore (talk) 21:15, 19 October 2024 (UTC)
Non-Gentoo installation media
Under Installation options for Gentoo, it still lists Knoppix as an example. I believe this should be changed to Linux Mint to match the most widely asked question "Can I install from Mint?"
Immolo (talk) 08:55, 21 September 2024 (UTC)
- Fixed in Special:Diff/1316760/1316762, thanks!
- --csfore (talk) 21:17, 19 October 2024 (UTC)