From: Dror Levin <spatz@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki
Date: Sun, 4 Apr 2010 17:15:03 +0300 [thread overview]
Message-ID: <q2p2becdd071004040715se14e5c18ne943b81447bf96bb@mail.gmail.com> (raw)
In-Reply-To: <20100404003152.4b2012da@angelstorm>
On Sun, Apr 4, 2010 at 10:31, Joshua Saddler <nightmorph@gentoo.org> wrote:
> No, he's definitely out to kill GuideXML. Just give him time.
Why the antagonism? Ben isn't out to kill anything, he has no personal
vendetta against anything. Actually, nothing here is personal, but you
seem offended by some of the things which are being said, and you
really shouldn't.
>> A wiki can fulfill several purposes for us:
>>
>> 1. Easy collaboration among devs, for brainstorming, developing new
>> documentation, assembling upcoming meeting agendas, and so on
>> [for which there currently is not really any obvious place]
>
> This is not *impossible* with our current setup; it can still be done in a few different ways:
>
> 1) project spaces in /proj/$LANG/foobar/ -- how hard is it to commit to CVS when going through document drafts?
> 2) devspaces -- it's easy enough to dump stuff in here for others to refer to
>
> However, a wiki *does* make it easier for everyone to jump right in and edit stuff as ideas are passed around, rather than waiting for someone to make changes to something in a devspace.
That's exactly what we're looking for. That's what makes a wiki useful
in the first place.
>> 3. A place to host and maintain our existing documentation
>> [which is currently in GuideXML]
>
> Entirely unnecessary duplication of effort. To quote the forum mods, "don't cross-post" . . . and especially don't do it if you'll be violating a doc license somewhere. It's one of the reasons why we don't use existing unofficial wiki content in our docs. I and the GDP have written about that ad nauseum over the years; just search the list archives.
>
>> I am not pushing for our existing documentation to be migrated into a
>> wiki at this point. But I think that once the place is there, and it
>> functions well, it would be the obvious next step to do so. As I said
>> before, the barrier to contributing and maintaining documentation is
>> much higher in the case of GuideXML, so it doesn't really make sense
>> to keep that around when we have a better solution.
>>
>> I know there are people who do not agree with me on this last point
>
> . . . to say the least.
>
> [snip]
>
> I ain't out to stop ya'll from using a wiki. I do agree that they have some advantages. However, I will point out how limited wikis are. They're not a magic bullet that will solve all our problems.
Why would you want to stop us? Have you been to gentoo-wiki.com? There
are a lot of *very* useful articles there. With all due respect to the
doc team (and I have tremendous respect for them and the splendid
documentation they have written for Gentoo), they're limited by
manpower, by time, and by scope. They simply can't cover all the
things that are interesting and useful for our users. Some examples
which can never be covered by the official documentation:
1. Most of the stuff that's on the Documentation, Tips & Tricks forum.
And all the stuff that's already there can not be updated or changed,
and cannot even be found easily, so it's just rotting there.
2. All hardware specific information that's extremely useful to users
(information for Macs, all kinds of laptops, netbooks, how to update
your BIOS, etc.)
3. HOWTO's and guides for *a lot* of the software on the tree (many
kinds of mail servers available, HTTP servers, databases, spam
filters, alternative init systems, boot loaders, experimental drivers,
etc.). Some of those are covered by official documentation, by it can
never cover it all.
And I could go on (please do not argue about a specific point where I
may not be accurate, that's not the point). Our users want this kind
of information available, they want to share the information they
learned, they want to improve guides written by other people, build
upon work done by others. Gentoo can earn so much from a system that
will allow this. Our users want to help us and each other, let's help
them to that.
Furthermore, when an article on the wiki reaches maturity, it can be
included in our official documentation. Stuff can move around between
official documentation and wiki. Out of date official documentation
can be moved to the wiki where it can be improved instead of rotting.
Both can coexist and feed each other, providing more answers overall.
A wiki is not a new concept. Users know what they're getting from a
wiki. They know it's not official, know it was written by other users,
know that not all information is necessarily accurate, up-to-date or
relevant. But you can't ignore how useful a wiki is, what new heights
we can reach with it.
At first, I'd wish for things to be migrated from the unofficial wiki
(if the license does not allow for copying, then re-writing it. Our
users will do a lot of it, I'm sure). I'd wish to migrate a lot of
things from the forums, after getting the authors permission if
necessary. Maybe at some point I'd like the devmanual to be moved to
the wiki (probably only editable by devs or a certain team, the
specifics are not important right now). The quizzes can be put on the
wiki. GLEP summaries in language users understand. Drafts for news
items. The list goes on and on.
Dror Levin
next prev parent reply other threads:[~2010-04-04 14:15 UTC|newest]
Thread overview: 84+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-04-03 13:19 [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki Ben de Groot
2010-04-03 13:40 ` Dror Levin
2010-04-03 14:12 ` Tobias Scherbaum
2010-04-03 14:36 ` Ben de Groot
2010-04-03 23:41 ` Sebastian Pipping
2010-04-03 15:03 ` Nathan Zachary
2010-04-03 17:40 ` AllenJB
2010-04-03 18:56 ` George Prowse
2010-04-03 19:04 ` Alex Legler
2010-04-04 23:19 ` Ben de Groot
2010-04-10 4:10 ` William Hubbs
2010-04-10 11:55 ` Ben de Groot
2010-04-10 12:06 ` Dror Levin
2010-04-10 15:25 ` William Hubbs
2010-04-10 15:40 ` George Prowse
2010-04-10 17:18 ` William Hubbs
2010-04-10 18:11 ` [gentoo-dev] " Duncan
2010-04-10 18:26 ` René 'Necoro' Neumann
2010-04-11 9:52 ` Duncan
2010-04-11 3:05 ` [gentoo-dev] " Patrick Nagel
2010-04-10 18:04 ` Vincent Launchbury
2010-04-10 19:23 ` Dale
2010-04-11 4:35 ` William Hubbs
2010-04-14 2:03 ` George Prowse
2010-04-10 13:35 ` George Prowse
2010-04-11 1:08 ` Jorge Manuel B. S. Vicetto
2010-04-03 14:04 ` Guy Fontaine
2010-04-03 14:12 ` Ben de Groot
2010-04-03 15:25 ` Sylvain Alain
2010-04-03 14:30 ` Alex Legler
2010-04-03 14:46 ` Ben de Groot
2010-04-03 23:37 ` Sebastian Pipping
2010-04-04 1:20 ` Ben de Groot
2010-04-04 7:31 ` Joshua Saddler
2010-04-04 8:29 ` Arun Raghavan
2010-04-04 8:47 ` Sebastian Pipping
2010-04-04 12:26 ` Ben de Groot
2010-04-04 8:48 ` Antoni Grzymala
2010-04-04 8:54 ` Sebastian Pipping
2010-04-04 9:10 ` Alex Legler
2010-04-04 12:31 ` Ben de Groot
2010-04-04 16:54 ` Antoni Grzymala
2010-04-04 9:01 ` Alex Legler
2010-04-04 10:35 ` AllenJB
2010-04-04 13:43 ` Sylvain Alain
2010-04-04 14:15 ` Dror Levin [this message]
2010-04-04 14:33 ` AllenJB
2010-04-04 14:47 ` Dror Levin
2010-04-04 15:13 ` AllenJB
2010-04-04 15:36 ` dev-random
2010-04-04 15:39 ` Ben de Groot
2010-04-04 16:08 ` Ben de Groot
2010-04-04 22:45 ` Zeerak Mustafa Waseem
2010-04-04 22:21 ` AllenJB
2010-04-04 23:11 ` Ben de Groot
2010-04-05 1:36 ` Zeerak Mustafa Waseem
2010-04-04 16:00 ` Ben de Groot
2010-04-04 15:23 ` Ben de Groot
2010-04-04 19:33 ` Joshua Saddler
2010-04-04 19:46 ` George Prowse
2010-04-05 0:08 ` Ben de Groot
2010-04-05 1:13 ` Joshua Saddler
2010-04-05 2:43 ` Ben de Groot
2010-04-05 5:04 ` Arun Raghavan
2010-04-05 5:05 ` Arun Raghavan
2010-06-07 12:27 ` Ed W
2010-06-07 12:19 ` Ed W
2010-04-04 9:30 ` Alex Legler
2010-04-03 19:13 ` Alex Legler
2010-04-03 23:44 ` Sebastian Pipping
2010-04-05 0:02 ` Alistair Bush
2010-04-05 0:25 ` Ben de Groot
2010-04-05 4:46 ` [gentoo-dev] " Duncan
2010-04-05 0:37 ` [gentoo-dev] " Matti Bickel
2010-04-05 2:01 ` Jorge Manuel B. S. Vicetto
2010-04-05 3:02 ` Ben de Groot
2010-06-03 20:44 ` René 'Necoro' Neumann
2010-06-03 22:49 ` Ben de Groot
2010-06-04 3:53 ` Tobias Scherbaum
2010-06-04 4:52 ` Sebastian Pipping
2010-06-04 5:51 ` [gentoo-dev] " Torsten Veller
2010-06-04 8:12 ` Markos Chandras
-- strict thread matches above, loose matches on Subject: below --
2010-04-04 0:11 [gentoo-dev] " Sylvain Alain
2010-04-04 0:24 ` Sebastian Pipping
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=q2p2becdd071004040715se14e5c18ne943b81447bf96bb@mail.gmail.com \
--to=spatz@gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox