Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 107231

Summary: Section 2 Kernel Setup could be improved
Product: [OLD] Docs-user Reporter: peterwlowe
Component: OtherAssignee: Docs Team <docs-team>
Status: RESOLVED WONTFIX    
Severity: trivial    
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
URL: http://www.gentoo.org/doc/en/home-router-howto.xml
Whiteboard:
Package list:
Runtime testing required: ---

Description peterwlowe 2005-09-25 19:29:05 UTC
The current document ends the last non-code text part of Section 2, Kernel Setup:

"It does not matter whether you build the features into the kernel or as a
module so long as when the feature is needed, the correct module(s) are loaded
(module loading is left to the reader as a fun exercise however)."

The final bit in parentheses comes off as a bit elitist, and could be improved.

Reproducible: Always
Steps to Reproduce:
Read http://www.gentoo.org/doc/en/home-router-howto.xml



The sentence could easily be rewritten to retain a funny tone, yet be helpful,
such as 

"If your module loading skills are rusty, consult the Gentoo Handbook for
examples, particularly Section 3.c on Manual Network configuration."
Comment 1 Jan Kundrát (RETIRED) gentoo-dev 2005-09-26 07:18:50 UTC
I don't think that it is elitist, I'd say that it's just an attempt to be 
funny. 
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2005-12-10 11:10:47 UTC
I agree; the sentence isn't offensive imo; rewriting it would just make our
translators unhappy.