Advanced
Mailing List Archive

Mailing List Archive

  1. Home >
  2. Gentoo>
  3. Dev
RFC - Gentoo Knowledge Base
swift at gentoo
May 16, 2006, 10:33 AM
Post #1 of 14 (490 views)
Permalink
Hi all,

For some time now, the idea of a Gentoo Knowledge Base, like RedHat [1]
and Microsoft [2] do, has been brewing in Andrés Pereira and my minds. Not
only that, but a feature request was also filed some time ago [3] and just
recently a forum thread was started for it [4].

So, what is this about?

A Knowledge Base provides answers to specific questions and problems that
users (or developers) might encounter. It is easily searchable and
maintained by developers who are knowledgeable in the topic. The knowledge
base entries ("topics" as I like to call them) are not documentation guides,
but very specific to a particular environment and question. They should
leave absolutely *no* room for different interpretations.

I have started a project site for this at
http://www.gentoo.org/proj/en/kbase. A mailinglist has been created and will
hopefully start a nice discussion about this topic. The mailinglist is
gentoo-kbase@gentoo.org afaik. Once we have a nice idea about where we want
to go (sic), a GLEP will probably follow for those who don't want to follow
the mailinglist but do want to know what we will be/are doing.

Wkr,
Sven Vermeulen

[1] http://kb.redhat.com
[2] http://support.microsoft.com
[3] https://bugs.gentoo.org/show_bug.cgi?id=102200
[4] http://forums.gentoo.org/viewtopic-t-462377.html

--
Gentoo Foundation Trustee | http://foundation.gentoo.org
Gentoo Council Member

The Gentoo Project <<< http://www.gentoo.org >>>
Re: RFC - Gentoo Knowledge Base [ In reply to ]
halcy0n at gentoo
May 16, 2006, 11:09 AM
Post #2 of 14 (493 views)
Permalink
Sven Vermeulen <swift@gentoo.org> said:
> A Knowledge Base provides answers to specific questions and problems that
> users (or developers) might encounter. It is easily searchable and
> maintained by developers who are knowledgeable in the topic. The knowledge
> base entries ("topics" as I like to call them) are not documentation guides,
> but very specific to a particular environment and question. They should
> leave absolutely *no* room for different interpretations.

I like it. It would be nice to be able to point someone to a doc or
something when they file a bug about something they did wrong, and this sounds
like it would fill that void.

--
Mark Loeser - Gentoo Developer (cpp gcc-porting qa toolchain x86)
email - halcy0n AT gentoo DOT org
mark AT halcy0n DOT com
web - http://dev.gentoo.org/~halcy0n/
http://www.halcy0n.com
Re: RFC - Gentoo Knowledge Base [ In reply to ]
halcy0n at gentoo
May 16, 2006, 11:09 AM
Post #3 of 14 (487 views)
Permalink
Sven Vermeulen <swift@gentoo.org> said:
> A Knowledge Base provides answers to specific questions and problems that
> users (or developers) might encounter. It is easily searchable and
> maintained by developers who are knowledgeable in the topic. The knowledge
> base entries ("topics" as I like to call them) are not documentation guides,
> but very specific to a particular environment and question. They should
> leave absolutely *no* room for different interpretations.

I like it. It would be nice to be able to point someone to a doc or
something when they file a bug about something they did wrong, and this sounds
like it would fill that void.

--
Mark Loeser - Gentoo Developer (cpp gcc-porting qa toolchain x86)
email - halcy0n AT gentoo DOT org
mark AT halcy0n DOT com
web - http://dev.gentoo.org/~halcy0n/
http://www.halcy0n.com
Re: RFC - Gentoo Knowledge Base [ In reply to ]
roy at crossford
May 16, 2006, 12:37 PM
Post #4 of 14 (493 views)
Permalink
On 2006.05.16 18:33, Sven Vermeulen wrote:
> Hi all,
>
[snip]
>
> I have started a project site for this at
> http://www.gentoo.org/proj/en/kbase.
[snip]
>
> --
> Gentoo Foundation Trustee | http://foundation.gentoo.org
> Gentoo Council Member
>
> The Gentoo Project <<< http://www.gentoo.org >>>
>
Sven,

Your link gives me a 404 error

Regards,

Roy Bamford
(NeddySeagoon)

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
roy at crossford
May 16, 2006, 12:37 PM
Post #5 of 14 (490 views)
Permalink
On 2006.05.16 18:33, Sven Vermeulen wrote:
> Hi all,
>
[snip]
>
> I have started a project site for this at
> http://www.gentoo.org/proj/en/kbase.
[snip]
>
> --
> Gentoo Foundation Trustee | http://foundation.gentoo.org
> Gentoo Council Member
>
> The Gentoo Project <<< http://www.gentoo.org >>>
>
Sven,

Your link gives me a 404 error

Regards,

Roy Bamford
(NeddySeagoon)

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
agaffney at gentoo
May 16, 2006, 12:56 PM
Post #6 of 14 (496 views)
Permalink
Roy Bamford wrote:
>> I have started a project site for this at
>> http://www.gentoo.org/proj/en/kbase.
> [snip]
> Sven,
>
> Your link gives me a 404 error

It works for me. Also, please don't reply twice to the list (you had the list
address in To and CC).

--
Andrew Gaffney http://dev.gentoo.org/~agaffney/
Gentoo Linux Developer Installer Project

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
christel at gentoo
May 16, 2006, 4:18 PM
Post #7 of 14 (489 views)
Permalink
On Tue, 2006-05-16 at 19:33 +0200, Sven Vermeulen wrote:
> Hi all,
>
> For some time now, the idea of a Gentoo Knowledge Base, like RedHat [1]
> and Microsoft [2] do, has been brewing in Andrés Pereira and my minds. Not
> only that, but a feature request was also filed some time ago [3] and just
> recently a forum thread was started for it [4].
>
> So, what is this about?
>
> A Knowledge Base provides answers to specific questions and problems that
> users (or developers) might encounter. It is easily searchable and
> maintained by developers who are knowledgeable in the topic. The knowledge
> base entries ("topics" as I like to call them) are not documentation guides,
> but very specific to a particular environment and question. They should
> leave absolutely *no* room for different interpretations.

I think that sounds excellent and like it certainly could fill some gaps
and be useful for users (and developers).





--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
pabloa at gmail
May 16, 2006, 4:27 PM
Post #8 of 14 (492 views)
Permalink
On 20:37 Tue 16 May , Roy Bamford wrote:
> On 2006.05.16 18:33, Sven Vermeulen wrote:
> >Hi all,
> >
> [snip]
> >
> >I have started a project site for this at
> >http://www.gentoo.org/proj/en/kbase.
> [snip]
> >
> >--
> > Gentoo Foundation Trustee | http://foundation.gentoo.org
> > Gentoo Council Member
> >
> > The Gentoo Project <<< http://www.gentoo.org >>>
> >
> Sven,
>
> Your link gives me a 404 error
>

This may sound silly but, are you sure you removed the last period
there? The link works for me.

> Regards,
>
> Roy Bamford
> (NeddySeagoon)
>
> --
> gentoo-dev@gentoo.org mailing list

--
Pablo Antonio (AKA crazy2k)
http://www.pablo-a.com.ar/

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
zr40.nl at gmail
May 16, 2006, 9:42 PM
Post #9 of 14 (492 views)
Permalink
On 5/17/06, Pablo Antonio <pabloa@gmail.com> wrote:
> On 20:37 Tue 16 May , Roy Bamford wrote:
> > On 2006.05.16 18:33, Sven Vermeulen wrote:
> > >Hi all,
> > >
> > [snip]
> > >
> > >I have started a project site for this at
> > >http://www.gentoo.org/proj/en/kbase.
> > [snip]
> > >
> > >--
> > > Gentoo Foundation Trustee | http://foundation.gentoo.org
> > > Gentoo Council Member
> > >
> > > The Gentoo Project <<< http://www.gentoo.org >>>
> > >
> > Sven,
> >
> > Your link gives me a 404 error
> >
>
> This may sound silly but, are you sure you removed the last period
> there? The link works for me.

It wasn't working the first two hours after the mail was sent, but
after those two hours, it did.

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
ml at kriga
May 17, 2006, 6:17 AM
Post #10 of 14 (496 views)
Permalink
Sven Vermeulen wrote:
> Hi all,
>
> For some time now, the idea of a Gentoo Knowledge Base, like RedHat [1]
> and Microsoft [2] do, has been brewing in Andrés Pereira and my minds. Not
> only that, but a feature request was also filed some time ago [3] and just
> recently a forum thread was started for it [4].
>
> So, what is this about?

Why reinvent the wheel?!?
Gentoo has a really nice wiki: <http://gentoo-wiki.com/Main_Page>


--
Kristian Gavran

E-Mail: ml@kriga.net
--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
flameeyes at gentoo
May 17, 2006, 6:23 AM
Post #11 of 14 (491 views)
Permalink
On Wednesday 17 May 2006 15:17, Kristian Gavran wrote:
> Why reinvent the wheel?!?
Because it's not the same thing, gentoo-wiki is not and can't be official,
there are many things there that are totally unsupported.
What Sven is proposing is (as far as I can see it) is something official and
officially supported.

--
Diego "Flameeyes" Pettenò - http://farragut.flameeyes.is-a-geek.org/
Gentoo/Alt lead, Gentoo/FreeBSD, Video, AMD64, Sound, PAM, KDE
Re: RFC - Gentoo Knowledge Base [ In reply to ]
pabloa at gmail
May 17, 2006, 7:11 AM
Post #12 of 14 (486 views)
Permalink
On 15:17 Wed 17 May , Kristian Gavran wrote:
> Sven Vermeulen wrote:
> >Hi all,
> >
> >For some time now, the idea of a Gentoo Knowledge Base, like RedHat [1]
> >and Microsoft [2] do, has been brewing in Andrés Pereira and my minds. Not
> >only that, but a feature request was also filed some time ago [3] and just
> >recently a forum thread was started for it [4].
> >
> >So, what is this about?
>
> Why reinvent the wheel?!?
> Gentoo has a really nice wiki: <http://gentoo-wiki.com/Main_Page>

As I said to Andrés yesterday, I think this is a good alternative.
AFAIK, the Knowledge Base will be an official source of information
(only developers will be able to post there) and that makes it more
reliable - I'm not saying that wiki is not trustworthy though. Also, the
KB will have specific answers for specific questions. That makes it a
good place to redirect people asking certain stuff on IRC.

>
>
> --
> Kristian Gavran
>
> E-Mail: ml@kriga.net
> --
> gentoo-dev@gentoo.org mailing list

--
Pablo Antonio (AKA crazy2k)
http://www.pablo-a.com.ar/

--
gentoo-dev@gentoo.org mailing list
Re: RFC - Gentoo Knowledge Base [ In reply to ]
swift at gentoo
May 17, 2006, 11:30 AM
Post #13 of 14 (493 views)
Permalink
On Wed, May 17, 2006 at 03:17:33PM +0200, Kristian Gavran wrote:
> Why reinvent the wheel?!?
> Gentoo has a really nice wiki: <http://gentoo-wiki.com/Main_Page>

A wiki is more of a documentation system than a knowledge base. I think some
KBs could very well employ a wiki as back-technology for writing the
articles. But a KB is more strict in its writing: it can have a fixed layout
(like "title, synopsis, environment, analysis, solution" [1]), allows for
additional metadata (keywords, references to other articles, point-system
per query, ...) and focuses more on its search technology than on the
writing.

Wkr,
Sven Vermeulen

[1] This is actually what I had in mind for the Gentoo KB

--
Gentoo Foundation Trustee | http://foundation.gentoo.org
Gentoo Council Member

The Gentoo Project <<< http://www.gentoo.org >>>
Re: RFC - Gentoo Knowledge Base [ In reply to ]
derheld42 at derheld
May 23, 2006, 11:43 PM
Post #14 of 14 (487 views)
Permalink
Sven Vermeulen <swift <at> gentoo.org> writes:
> On Wed, May 17, 2006 at 03:17:33PM +0200, Kristian Gavran wrote:
> > Why reinvent the wheel?!?
> > Gentoo has a really nice wiki: <http://gentoo-wiki.com/Main_Page>
>
> A wiki is more of a documentation system than a knowledge base. I think some
> KBs could very well employ a wiki as back-technology for writing the
> articles. But a KB is more strict in its writing: it can have a fixed layout
> (like "title, synopsis, environment, analysis, solution" [1]), allows for
> additional metadata (keywords, references to other articles, point-system
> per query, ...) and focuses more on its search technology than on the
> writing.

I believe that a wiki can serve as a knowledge base. There are wikis out there
that allow for fixed layouts and user defined metadata such as you describe
above. There are also wikis that can divide up into "webs" to facilitate
different environments such as a user-driven documentation area and a formal
only developer posting allowed area. In addition, wikis can provide access
control to allow only developers to post to to certain "webs" and/or specific
wiki pages.

I realize the gentoo wiki already exists, but I know that http://www.twiki.org
supports everything I'm mentioning..

Just trying to make gentoo even better :)

Thanx!
Carter

--
gentoo-dev@gentoo.org mailing list

©2024 GT.net. A Gossamer Threads company.
5th Floor, 455 Granville St., Vancouver, BC V6C 1T1, Canada | Legal