Handbook Talk:AMD64/Installation/About

From Gentoo Wiki
Jump to: navigation, search
Note
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.
Talk status
This discussion is still ongoing.

CSS margin-bottom bugs

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)