[gentoo-amd64] doc index

[gentoo-amd64] doc index

[Simon Stelling]

Hi all,

I remember some time ago somebody on this list mentioned that our 
documentation is somewhat spread all over the gentoo site. I have 
updated our project page [1] to list all user documentation just on the 
top and all further resources in a seperate chapter at the bottom of the 
page. There is not more documentation then before, but at least you now 
know where to look for it. If it's not listed on the project page, it 
probably doesn't exist or is not amd64-related.

[1] http://amd64.gentoo.org/

-- 
Kind Regards,

Simon Stelling
Gentoo/AMD64 developer
-- 
gentoo-amd64@gentoo.org mailing list

[gentoo-amd64] Re: doc index

[Duncan]

Simon Stelling <blubb@gentoo.org> posted 45278719.7070403@gentoo.org,
excerpted below, on  Sat, 07 Oct 2006 12:53:13 +0200:

> I remember some time ago somebody on this list mentioned that our 
> documentation is somewhat spread all over the gentoo site. I have 
> updated our project page [1] to list all user documentation just on the 
> top and all further resources in a seperate chapter at the bottom of the 
> page. There is not more documentation then before, but at least you now 
> know where to look for it. If it's not listed on the project page, it 
> probably doesn't exist or is not amd64-related.
> 
> [1] http://amd64.gentoo.org/

That was me.  Thanks!  It'll be much simpler to tell folks were to look,
now.  =8^)

Two further suggestions:

1) Consider generalizing the bug-filing HOWTO a bit (beyond keywording),
and linking it at the top under documentation.  Gentoo's bugzilla
needs a bit of extra hand-holding the first time or two, even for the
normally pretty technically literate who may have filed bugs elsewhere
before, and this should help a bit with quality plus encouraging them to
be filed.

2) One more line under documentation, mentioning the further resources at
the bottom, might be nice.

Otherwise, looks great, and it's /definitely/ more useful for the average
user than it was before! =8^)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

-- 
gentoo-amd64@gentoo.org mailing list

Re: [gentoo-amd64] Re: doc index

[Simon Stelling]

Duncan wrote:
> 1) Consider generalizing the bug-filing HOWTO a bit (beyond keywording),
> and linking it at the top under documentation.  Gentoo's bugzilla
> needs a bit of extra hand-holding the first time or two, even for the
> normally pretty technically literate who may have filed bugs elsewhere
> before, and this should help a bit with quality plus encouraging them to
> be filed.

I have deleted all links to this one as it is out of date and there is 
actually not much to do anymore. You can file a bug in a completely 
fubared manner, it will still reach us, thanks to jakub ;) So, I think 
this document is entirely deprecated. Sure, it would probably encourage 
people to file them, but then, at least in regard to ~amd64 keyword 
requests, we're hopelessly overworked. Most of these bugs are lying 
around for a loooong time simply because it's even hard for us to keep 
up with the stablization request and normal bugfixing, which both have 
much higher priorities.

> 2) One more line under documentation, mentioning the further resources at
> the bottom, might be nice.

Should show up with the next cvs<->www sync. Could make it a link though 
because GuideXML doesn't use semantic anchors for the pages it generates :/

-- 
Kind Regards,

Simon Stelling
Gentoo/AMD64 developer
-- 
gentoo-amd64@gentoo.org mailing list