Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 100118 - Install docs page has misleading handbook links
Summary: Install docs page has misleading handbook links
Status: VERIFIED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: Xavier Neys (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-07-24 07:52 UTC by Matt Beswick (Soir)
Modified: 2005-07-27 16:17 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Matt Beswick (Soir) 2005-07-24 07:52:35 UTC
http://www.gentoo.org/doc/en/index.xml?catid=install has two handbook links, one
just labelled as the Gentoo Handbook and one labelled the Gentoo 2005.0 Handbook.
For people who know they're installing 2005.0, the choice looks obvious -- but
wait a sec, the latter of these actually leads to the networkless install. A good
idea would be to actually list the Gentoo version currently covered by the main
handbook, in its description. Then retag the 2005.0 one as 'Networkless' and
mention as such in the description for that.

Mostly a newbie thing, but even I was hit by it back when I was new, and I'm
somewhat surprised nobody's filed on it yet. :)
Comment 1 Jan Kundrát (RETIRED) gentoo-dev 2005-07-26 04:18:23 UTC
What about "s:It contains the installation instructions for the 2005.0 
release:It contains the networkless installation instructions for the 2005.0 
release:" for doc/en/handbook/2005.0/handbook-*.xml? 
Comment 2 Jan Kundrát (RETIRED) gentoo-dev 2005-07-26 04:47:23 UTC
(In reply to comment #1) 
> What about "s:It contains the installation instructions for the 2005.0  
> release:It contains the networkless installation instructions for the 2005.0  
> release:" for doc/en/handbook/2005.0/handbook-*.xml?  
 
Er, I was talking about <summary> of doc/en/handbook/2005.0/index.xml. 
 
Comment 3 Xavier Neys (RETIRED) gentoo-dev 2005-07-26 04:58:38 UTC
(In reply to comment #2)
> (In reply to comment #1) 
> > What about "s:It contains the installation instructions for the 2005.0  
> > release:It contains the networkless installation instructions for the 2005.0  
> > release:" for doc/en/handbook/2005.0/handbook-*.xml?  
>  
> Er, I was talking about <summary> of doc/en/handbook/2005.0/index.xml. 
>  

My own thoughts :)
Comment 4 Xavier Neys (RETIRED) gentoo-dev 2005-07-26 05:00:02 UTC
BTW, it's only in /doc/en/handbook.2005.0/index.xml, not in the books themselves
Comment 5 Xavier Neys (RETIRED) gentoo-dev 2005-07-26 05:21:37 UTC
Time to head for coffee :)

Fixed. Thanks for reporting.
Comment 6 Matt Beswick (Soir) 2005-07-27 16:17:52 UTC
I dunno, it still seems like it could be ambiguous, but the next page does
certainly make it rather more clear, and I won't fault that. Checked, closing.
Thanks.