I'm one of members of #gentoo-br channel, and various times I see that when a user ends install by reading handbook user asks for example 'And now, how I install KDE?'. Okay, seeing the 'Where to go from here?' section I sugest that talk more about instalation of Xorg, KDE, Gnome and at minimum XFCE. How? Putting direct links to documentations about these things like configuration How To's inside Gentoo Desktop Documentation Resources section. This addition is to help new users to have a good desktop in minor time. Thx and good work. Reproducible: Always Steps to Reproduce: 1.Install Gentoo using handbook 2.End install 3.Ask on channel about kde & cia Actual Results: Various users asking what can do to have a kde/gnome/xfce installed. Expected Results: Expect that users can install and configure only seeing docs in Handbook.
Here http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=12 we have a bunch of links to different stuff. Among others is this: http://www.gentoo.org/doc/en/index.xml?catid=desktop We have all the guides you have mentioned listed on this page (and many more) linked (almost) directly from the handbook. I guess users just fail to read the handbook till the end. They can always type "gentoo xorg" into google. Our guide will pop-up as the first result. This is a common case for everything else, like "gentoo gnome", "gentoo kde" and so on. On #gentoo-pl we have a bot which googles for users. Here's how it works: 06:27 < rane> .gdoc xorg 06:28 < gen2bot> Dokumentacja Gentoo Linux -- Konfiguracja serwera X: http://www.gentoo.org/doc/pl/xorg-config.xml 06:28 < rane> .t ch4os gdoc xorg 06:28 < gen2bot> ch4os: Dokumentacja Gentoo Linux -- Konfiguracja serwera X: http://www.gentoo.org/doc/pl/xorg-config.xml It searches links (and checks if the doc is available in Polish) and gives the link. You can even make bot talk directly to the person asking which is a common situation on the channel. It's all standard pybot stuff. Maybe this is the way for you to go? I don't know how to improve the handbook. Adding there all 400 direct links to our guides will clutter it and choosing those to link directly to on arbitrary basis isn't also a good idea. I'd leave it the way it is (aka a direct link to desktop resources). The bug is RESO WONTFIX (+ maybe teach your bot more tricks) for me...
(In reply to comment #1) > I'd leave it the way it is (aka a direct link to desktop resources). The bug is > RESO WONTFIX (+ maybe teach your bot more tricks) for me... Agreed. rane presented many excellent reasons for keeping it the way it is. It's enough that we list our resources on the indicated desktop page -- there are many other things related to setting up a desktop besides just installing Gnome/KDE/Xfce. As long as users read all the way through the handbook, there's no problem. Another problem with arbitrarily listing individual documents in the handbook is that filenames can change and move around; the recent move of the KDE guide is one example. It's enough to keep track of them in metadoc.xml, from which our resources page is dynamically generated.