[gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Sven Vermeulen 
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
[EMAIL PROTECTED] 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 >>>


pgpjNisgV7ilQ.pgp
Description: PGP signature

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Mark Loeser 
Sven Vermeulen <[EMAIL PROTECTED]> 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


pgpxbBF0qj8v3.pgp
Description: PGP signature

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Roy Bamford 

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: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Andrew Gaffney 

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 Gaffneyhttp://dev.gentoo.org/~agaffney/
Gentoo Linux Developer   Installer Project

--
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Pablo Antonio 
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: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-16 Thread Matthijs van der Vleuten 

On 5/17/06, Pablo Antonio <[EMAIL PROTECTED]> 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: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-17 Thread Christel Dahlskjaer 
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: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-17 Thread Kristian Gavran 

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: 


--
  Kristian Gavran

  E-Mail: [EMAIL PROTECTED]
--
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-17 Thread Diego 'Flameeyes' Pettenò 
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


pgpsIuW33padP.pgp
Description: PGP signature

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-17 Thread Pablo Antonio 
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: 

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: [EMAIL PROTECTED]
> -- 
> gentoo-dev@gentoo.org mailing list

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

-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] RFC - Gentoo Knowledge Base

2006-05-17 Thread Sven Vermeulen 
On Wed, May 17, 2006 at 03:17:33PM +0200, Kristian Gavran wrote:
> Why reinvent the wheel?!?
> Gentoo has a really nice wiki: 

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 >>>


pgpWF5fj80AZY.pgp
Description: PGP signature