Which distro has the best documentation?

Infohawk

Lifer
Jan 12, 2002
17,844
1
0
I'm not sure if this belongs in the "which distro is right for me thread" but I think it deserves its own topic and in any case I'm not planning on changing distros anytime soon. Right now I'm using debian unstable. I'm not crazy about the documentation. The problem with debian unstable is that its a moving target and not too prone to good documentation. I know there's stable and testing but I like reasonably recent packages.

I briefly looked at fedora's docs and thought it was pretty nice-looking. I briefly looked at Mandrake's site and the docs still referred to 9.1. This brings me to what I think makes good documentation:

-comprehensive
-up-to-date

I think up-to-date is the most difficult thing for linux distros. Most distros release new editions every six months. It's apparently hard to keep the docs up to date. Based on Mandrake's site, they haven't done this yet. I looked at fedora's site right after it was released and it was there. Shouldn't docs be part of a release and not an afterthought? :/

Anyway, which distros do you think have good docs and why? And examples (links)?

Lately I've become more interested in documentation because I'm tired of asking people on irc for help. When documentation is good, it solves questions quickly and without attitude. Google simply gives you too much information and frankly I don't trust it. A lot of time you'll see an archived post referring to another version. Worse, sometimes certain fixes will cause problems elsewhere in the system if you aren't hearing it from the horse's mouth.
 

n0cmonkey

Elite Member
Jun 10, 2001
42,936
1
0
I've had a lot of good luck with google.

Over all, I think that all of the Linux distros have horrible documentation. I haven't found one yet that was as good as other FOSS OS projects.
 

Sunner

Elite Member
Oct 9, 1999
11,641
0
76
IMO the distro with the best documentation is Gentoo.
Granted, I didn't use it all that much, but when I did, it was always helpful.

Of course Im talking about the online distro specific documentation now, manpages are pretty much the same, and when it comes to manpages, OpenBSD is unrivaled IMO.
 

Nothinman

Elite Member
Sep 14, 2001
30,672
0
0
Frankly I think Debian has the best documentation. Everything has a man page, or will since not having one is a bug, and /usr/share/doc/packagename is almost always populated with everything from the upstream site and if it's not that genreally means there's a package-doc package that contains it.

Lately I've become more interested in documentation because I'm tired of asking people on irc for help. When documentation is good, it solves questions quickly and without attitude. Google simply gives you too much information and frankly I don't trust it. A lot of time you'll see an archived post referring to another version. Worse, sometimes certain fixes will cause problems elsewhere in the system if you aren't hearing it from the horse's mouth.

If you didn't know, you can use google to search specific sites just by appending 'site:Debian.org' to the end of the search string. That's generally how I search Microsoft's support and MSDN sites since their search engine sucks, but it works for any site that google has indexed.
 

Infohawk

Lifer
Jan 12, 2002
17,844
1
0
I agree that Debian has good per-app documentation. I guess I was thinking more of task-oriented docs that cover the distro itself. It seems like you need to know which package does what before you can get help for a given task.
 

GhettoFob

Diamond Member
Apr 27, 2001
6,800
0
76
I've been using Gentoo for the past year. It has really good documentation and the forums are very helpful. I don't have too much experience with other distros though.
 

groovin

Senior member
Jul 24, 2001
857
0
0
gentoo. the install manual is very well written. otherwise, what they lack in docs they make up for in forums and community help. Ive posted questions to the gentoo.org forums and gotten several replies back in minutes. ive been using gentoo now for 5 months. prior to that i was using red hat (dead rat?). I thought red hat had pretty good documentation... a little on the newbie side, but it did the job.

but even gentoo's docs have their shortcomings. i ran into some problems where i could have saved hours of trouble shooting torture if the install guide had just given a few precautions.
 

Goosemaster

Lifer
Apr 10, 2001
48,775
3
81
Originally posted by: groovin
gentoo. the install manual is very well written. otherwise, what they lack in docs they make up for in forums and community help. Ive posted questions to the gentoo.org forums and gotten several replies back in minutes. ive been using gentoo now for 5 months. prior to that i was using red hat (dead rat?). I thought red hat had pretty good documentation... a little on the newbie side, but it did the job.

but even gentoo's docs have their shortcomings. i ran into some problems where i could have saved hours of trouble shooting torture if the install guide had just given a few precautions.

aye. Fros such a nice [and complicated] distro, nothing beats the gentoo install man. It isn't perfect, but I have yet to see such a nice [and free] install manual including kernel compilation in detail.
 

groovin

Senior member
Jul 24, 2001
857
0
0
Originally posted by: BingBongWongFooey
Thankfully most distro installs don't even involve a kernel compile. ;)

what? you mean there are people out there that dont enjoy a late night kernel compile?!?!...

=)
 

Nothinman

Elite Member
Sep 14, 2001
30,672
0
0
aye. Fros such a nice [and complicated] distro, nothing beats the gentoo install man. It isn't perfect, but I have yet to see such a nice [and free] install manual including kernel compilation in detail.

Huh? I went through a stage1 install on my Alpha and the docs explained nothing, all they do is say 'run this, now run this, now run this', how is that good documentation?
 

Vadatajs

Diamond Member
Aug 28, 2001
3,475
0
0
Originally posted by: Nothinman
aye. Fros such a nice [and complicated] distro, nothing beats the gentoo install man. It isn't perfect, but I have yet to see such a nice [and free] install manual including kernel compilation in detail.

Huh? I went through a stage1 install on my Alpha and the docs explained nothing, all they do is say 'run this, now run this, now run this', how is that good documentation?


gentoo handbook for alpha. It looks like they divided the instructions into a quick install guide, and a more detailed handbook. Sounds like you were using the quick install guide.
 

drag

Elite Member
Jul 4, 2002
8,708
0
0
Originally posted by: groovin
Originally posted by: BingBongWongFooey
Thankfully most distro installs don't even involve a kernel compile. ;)

what? you mean there are people out there that dont enjoy a late night kernel compile?!?!...

=)

I don't mind the compile time for stuff, especially when I am asleep. ;)

Of course the third time thru a kernel compile because I keep on screwing up the config options can be pretty irritating.
 

Nothinman

Elite Member
Sep 14, 2001
30,672
0
0
gentoo handbook for alpha. It looks like they divided the instructions into a quick install guide, and a more detailed handbook. Sounds like you were using the quick install guide.

I don't think the handbook was around then, or atleast I didn't see it. But anyway, giving it a quick glance shows errors just on the partitioning instructions, they keep refering to the slice devices as /dev/sdaa, /dev/sdab, etc when they are numbered just like on any other architecture (i.e. /dev/sda1, /dev/sda2, etc) even though you refer to the slices by letter in fdisk. Either that or Gentoo is using different device names on Alpha for whatever reason.
 

CTho9305

Elite Member
Jul 26, 2000
9,214
1
81
Originally posted by: Sunner
Of course Im talking about the online distro specific documentation now, manpages are pretty much the same, and when it comes to manpages, OpenBSD is unrivaled IMO.
 

silverpig

Lifer
Jul 29, 2001
27,703
12
81
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.
 

n0cmonkey

Elite Member
Jun 10, 2001
42,936
1
0
Originally posted by: silverpig
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.

And someone goes through the forums and makes a central FAQ out of all of the FAQs?
 

groovin

Senior member
Jul 24, 2001
857
0
0
i found freebsd's handbook to be very helpful as well while some peopel i know hate it. its all opinion.
 

silverpig

Lifer
Jul 29, 2001
27,703
12
81
Originally posted by: n0cmonkey
Originally posted by: silverpig
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.

And someone goes through the forums and makes a central FAQ out of all of the FAQs?

Pretty much yeah. Once enough threads have been compiled on a subject, someone will come along and condense them all with very very clear instructions on how to set something up, making sure the common pitfalls are avoided. It's great.
 

n0cmonkey

Elite Member
Jun 10, 2001
42,936
1
0
Originally posted by: silverpig
Originally posted by: n0cmonkey
Originally posted by: silverpig
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.

And someone goes through the forums and makes a central FAQ out of all of the FAQs?

Pretty much yeah. Once enough threads have been compiled on a subject, someone will come along and condense them all with very very clear instructions on how to set something up, making sure the common pitfalls are avoided. It's great.

Sounds like something that should be done here. ;)
 

Sunner

Elite Member
Oct 9, 1999
11,641
0
76
Originally posted by: n0cmonkey
Originally posted by: silverpig
Originally posted by: n0cmonkey
Originally posted by: silverpig
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.

And someone goes through the forums and makes a central FAQ out of all of the FAQs?

Pretty much yeah. Once enough threads have been compiled on a subject, someone will come along and condense them all with very very clear instructions on how to set something up, making sure the common pitfalls are avoided. It's great.

Sounds like something that should be done here. ;)

[Doc Holiday]Whatever do you mean?[/Doc Holiday]
 

n0cmonkey

Elite Member
Jun 10, 2001
42,936
1
0
Originally posted by: Sunner
Originally posted by: n0cmonkey
Originally posted by: silverpig
Originally posted by: n0cmonkey
Originally posted by: silverpig
Another vote for gentoo. They have install guides for everything. They've got one main one for installing and setting up the OS, probably the best ALSA config guide I've seen yet, ones for X, miscellaneous programs etc.

I actually find their forums to be the most helpful of any I've been to. What's great is you can be sure someone else has had the problem before you. Just search "ati driver 2.6" and you'll find 10 threads explaining problems and solutions to setting up your ati driver with a 2.6 kernel. I haven't had to post a single question there yet as they've all been asked and answered previously.

And someone goes through the forums and makes a central FAQ out of all of the FAQs?

Pretty much yeah. Once enough threads have been compiled on a subject, someone will come along and condense them all with very very clear instructions on how to set something up, making sure the common pitfalls are avoided. It's great.

Sounds like something that should be done here. ;)

[Doc Holiday]Whatever do you mean?[/Doc Holiday]

As members of the Anantech Forums we must fight against the uprising of newbies! AndyHui is just one man, he cannot defeat them all! They can take our bandwidth, but they can never... Ok, can't even finish this one. I'll go back to my last starfighter quote: Greetings Starfighter, you have been recruited by the Star League to defend the Frontier against Xor and the Codan Armada. Ready? Perpare to blast off.
 

Olias

Senior member
Sep 3, 2000
529
0
0
Reading = Learning. That is why good documentation is key in selecting a distro. I have used many different distros and have bought many Linux books. I have learned the most from Gentoo and all the docs are on-line. One excellent resource book though is 'Linux in a Nutshell.
 

NerdOfTheNorth

Junior Member
Dec 29, 2003
23
0
0
I can honestly say that after trying to install about 5 different distros, I learned more and was far better educated from the Gentoo Docs than anything else.