Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 209399 - Gentoo Project to Have a Wiki
Summary: Gentoo Project to Have a Wiki
Status: RESOLVED INVALID
Alias: None
Product: Community Relations
Classification: Unclassified
Component: User Relations (show other bugs)
Hardware: All All
: High enhancement (vote)
Assignee: Gentoo Community Relations Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-02-08 21:54 UTC by mimosinnet
Modified: 2013-09-14 15:01 UTC (History)
0 users

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 mimosinnet 2008-02-08 21:54:54 UTC
Users have often asked for a wiki to be somehow supported by the gentoo project. The wiki could have a BIG WARNING saying that the information is not accurate. This has been discussed in this thread:
http://forums.gentoo.org/viewtopic-t-575709-highlight-.html
Also, Se7enLC, in this post: http://forums.gentoo.org/viewtopic.php?p=4833863 gives some arguments for having a gentoo community wiki:

"This topic comes up fairly often. There is a place for static pages, wikis, web forums, and mailing lists, and they are all slightly different. 
 
The official documentation on gentoo.org makes sense to have as static documents. They've been written,edited, checked, and should be as up-to-date as any documentation there is for gentoo. However, the nature of the beast says that it can't cover all topics (too much work in editing and updating), and it can't ever be bleeding edge (editing takes time). 
 
 Forums are good for a quick answer. "Hey, I'm having a problem with my ____" "oh hey, I had that problem, try patchset xyz". This is a great purpose. But if you are searching through to find something, you end up finding a lot of suggestions that didn't work for that person, and a LOT of outdated information. You'll read through a 10 page thread about your hardware, only to find on page 8 that somebody mentions "oh, you don't need to do that anymore, that was only kernels older than 2.6.9" or something, thereby negating all the how-tos. Some threads are great, and they original poster goes back and edits the first post to include a lot of information. That's basically doing the job of a wiki. 
 
Wikis are good for information that changes at a medium rate. It's not so static that you can write it in stone, but it changes infrequently enough that you want to have a copy of it available for reference. It puts all the information in one place and makes it easy to add or correct something. When compared to a forum post, a wiki can just contain a simple "This method is outdated, try this instead". A forum post generally will only contain that tag in a reply on a distant page. 
 
Mailing lists are good for VERY quick responses, but are lacking a lot of features for information retention and organization."


Reproducible: Always
Comment 1 Alec Warner (RETIRED) archtester gentoo-dev Security 2008-02-09 00:08:43 UTC
What is wrong with gentoo-wiki?

-Alec
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2008-02-09 08:15:06 UTC
(In reply to comment #1)
> What is wrong with gentoo-wiki?

It's all wrong... and that's how every unmoderated wiki is going to end up. Unless we have the manpower to maintain the content up to a decent level, no point at all in creating gentoo-wiki.com alternatives. It's unofficial and that's how it should remain.

Plus this really really really belongs to mailing lists and not bugzilla. ;)
Comment 3 Alec Warner (RETIRED) archtester gentoo-dev Security 2008-02-09 10:45:05 UTC
(In reply to comment #2)
> (In reply to comment #1)
> > What is wrong with gentoo-wiki?
> 
> It's all wrong... and that's how every unmoderated wiki is going to end up.
> Unless we have the manpower to maintain the content up to a decent level, no
> point at all in creating gentoo-wiki.com alternatives. It's unofficial and
> that's how it should remain.
> 
> Plus this really really really belongs to mailing lists and not bugzilla. ;)
> 

I meant as a user; developers can complain about how much gentoo-wiki may suck but it is not a resource for developers, it is a resource for users.  My question for users is 'is there something wrong with gentoo-wiki such that Gentoo itself should host its own wiki?'

Personally our infrastructure team does not like the idea which is a big part of why we don't have one.  Another good reason is that gentoo-wiki.org is a pretty good resource for interested folks and there is no reason to duplicate efforts.

-Alec
Comment 4 mimosinnet 2008-02-11 20:07:31 UTC
(In reply to comment #2)
> (In reply to comment #1)
> > What is wrong with gentoo-wiki?

The gentoo-wiki is great. There seems to be some reticence to include a link to the gentoo-wiki in the gentoo.org.

> Plus this really really really belongs to mailing lists and not bugzilla. ;)
 
Ups, Sorry! My apologies!