| 1 |
On Sat, Jun 03, 2006 at 07:44:24PM +0200, Sven Vermeulen wrote: |
| 2 |
> I've written what I see as the requirements document for the Knowledge Base. |
| 3 |
> It is drafted as a GLEP because the document lists what the Knowledge Base |
| 4 |
> ought to do/know/support/feature/contain. When accepted, we know what to do |
| 5 |
> :-) |
| 6 |
> |
| 7 |
> You can find it at http://dev.gentoo.org/~swift/tmp/kbase-glep.html. And, as |
| 8 |
> promised, a few topics to clarify what I have in mind... |
| 9 |
> |
| 10 |
> ** Issues |
| 11 |
> |
| 12 |
> - I accidentally wiped my entire /var and didn't have a backup. Can I |
| 13 |
> regenerate the important files? |
| 14 |
> |
| 15 |
> http://dev.gentoo.org/~swift/tmp/kb-fixvar.html |
| 16 |
> |
| 17 |
> - New kernel does not seem to have any effect |
| 18 |
> |
| 19 |
> http://dev.gentoo.org/~swift/tmp/kb-mountboot.html |
| 20 |
> |
| 21 |
> - Kernel Panic: Unable to mount root fs |
| 22 |
> |
| 23 |
> http://dev.gentoo.org/~swift/tmp/kb-rootfs.html |
| 24 |
> |
| 25 |
> - Some local filesystems failed to mount |
| 26 |
> |
| 27 |
> http://dev.gentoo.org/~swift/tmp/kb-wrongfstab.html |
| 28 |
> |
| 29 |
> ** FAQs |
| 30 |
> |
| 31 |
> - Is it possible to install Gentoo within Windows? |
| 32 |
> |
| 33 |
> http://dev.gentoo.org/~swift/tmp/faq-gentooinwindows.html |
| 34 |
> |
| 35 |
> - What is NPTL? |
| 36 |
> |
| 37 |
> http://dev.gentoo.org/~swift/tmp/faq-gentooinwindows.htm |
| 38 |
> |
| 39 |
> Fire away! |
| 40 |
> |
| 41 |
> Sven Vermeulen |
| 42 |
|
| 43 |
First of all, let me say I think establishing an knowledge base is a |
| 44 |
good thing ! Back in the days I used windows as my OS (those days are |
| 45 |
long, long gone) I used their KB quite often, either directly or because |
| 46 |
google pointed me to it. |
| 47 |
|
| 48 |
I'm not sure what you want feedback on, I'll just say everything I have |
| 49 |
on my mind now :) |
| 50 |
|
| 51 |
- Every entry should contain a 'last updated' field. nothing is more |
| 52 |
annoying than to try a suggestion, only to find out the information is |
| 53 |
from 2001 |
| 54 |
|
| 55 |
- Also, it would be a good thing to give every entry a unique, static |
| 56 |
KB ID, visible on the page itself, just like MS's KB. For easy |
| 57 |
referring and all. |
| 58 |
|
| 59 |
- Change Logs I'm not so sure about; It is useful information for |
| 60 |
editors/developers, but it's almost pointless for a normal user. It's |
| 61 |
unlikely that they will keep a topic bookmarked and check up on it |
| 62 |
every once it a while - normal usage would be: I broke something, I |
| 63 |
need it fixed now, what can you tell me? |
| 64 |
|
| 65 |
- A section pointing to other similar topics might be useful |
| 66 |
|
| 67 |
|
| 68 |
I wondered, have you thought about linkage with the forum ? Atm it |
| 69 |
contains quite a few topics that would fit in the KB, so we probably |
| 70 |
have to port them one day. The 'user comments' from your glep could then |
| 71 |
link back to the origal post, using the forum for the comments. |
| 72 |
|
| 73 |
|
| 74 |
Ceesjan |
| 75 |
|
| 76 |
PS: your glep states 'Last-Modified: 2005/09/20 19:32:36'... that's |
| 77 |
probably not correct ;) |
| 78 |
|
| 79 |
-- |
| 80 |
gentoo-kbase@g.o mailing list |
Archives