Bug 100118 – Install docs page has misleading handbook links

• Product: [OLD] Docs-user
• Status: VERIFIED FIXED

[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) 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) 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) 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) 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) 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.