| 1 |
-----BEGIN PGP SIGNED MESSAGE----- |
| 2 |
Hash: SHA1 |
| 3 |
|
| 4 |
Joshua Nichols wrote: |
| 5 |
> Maurice van der Pot wrote: |
| 6 |
>> Hi, |
| 7 |
>> |
| 8 |
>> I've noticed in the past that a lot of people come to irc with problems |
| 9 |
>> in some area (say networking) that are easy to solve just by first |
| 10 |
>> asking a number of questions to identify the problem and then providing |
| 11 |
>> the solution. |
| 12 |
>> |
| 13 |
>> I've always liked the way Microsoft put these troubleshooters in their |
| 14 |
>> help files. While the content of Microsoft's troubleshooters probably |
| 15 |
>> never really helped anyone, the format of a troubleshooter is in my |
| 16 |
>> opinion one of the best ways to help people solve their own problems. |
| 17 |
>> |
| 18 |
>> Now I've hacked up a program that can create a troubleshooter from |
| 19 |
>> specifications of questions and problems and their dependencies, but I'd |
| 20 |
>> need to have some decent content to really make it useful for other |
| 21 |
>> people. |
| 22 |
>> |
| 23 |
>> I think having a couple of Gentoo-specific troubleshooters would be a |
| 24 |
>> great resource for new users (not just new to Gentoo, but new to Linux). |
| 25 |
>> |
| 26 |
>> I have a couple of questions: |
| 27 |
>> |
| 28 |
>> 1) Does this sound like a good idea? |
| 29 |
>> |
| 30 |
>> 2) Does anyone feel like pouring his/her troubleshooting skills into |
| 31 |
>> content for my program? |
| 32 |
>> |
| 33 |
>> The program is still very immature (I skipped a lot of things that |
| 34 |
>> weren't absolutely necessary for the program to show what it can do), |
| 35 |
>> but that'll be fixed. |
| 36 |
>> |
| 37 |
>> When given proper input, it generates HTML files that you can click |
| 38 |
>> through and that will hopefully lead you to (a solution to) your problem. |
| 39 |
>> It has some sample content to show the format. |
| 40 |
>> |
| 41 |
>> Maurice. |
| 42 |
>> |
| 43 |
>> |
| 44 |
>> http://griffon26.kfk4ever.com/~griffon26/troubleshooter-0.0.2.tar.bz2 |
| 45 |
>> 43f0042c802ad5ddcdf2a4db671c41c8 *troubleshooter-0.0.2.tar.bz2 |
| 46 |
>> |
| 47 |
>> |
| 48 |
> If I'm not mistaken, the kbase project was established to help with this |
| 49 |
> type of information: |
| 50 |
> |
| 51 |
> http://www.gentoo.org/proj/en/kbase/ |
| 52 |
> |
| 53 |
Well . . . almost. This "troubleshooters" sounds like a distant cousin of what |
| 54 |
we originally set out to do. We didn't plan just to do troubleshooting -- more |
| 55 |
like specific quick howtos that didn't necessarily need a whole guide. More "How |
| 56 |
do I do this (amazingly obscure though it may be)" rather than "how do I fix |
| 57 |
this problem sequentially" -- though there would obviously be fix-it howtos as |
| 58 |
well. kbase was supposed to be the gathering place for information that really |
| 59 |
didn't belong in a guide in /doc/en/ for one reason or another...like collecting |
| 60 |
all the tips'n'tricks from the DT&T forum. |
| 61 |
|
| 62 |
At the very least, Troubleshooters is not remotely the format kbase was planning |
| 63 |
on using, as it wouldn't be effective. |
| 64 |
-----BEGIN PGP SIGNATURE----- |
| 65 |
Version: GnuPG v1.4.5 (GNU/Linux) |
| 66 |
|
| 67 |
iD8DBQFFL6e3rsJQqN81j74RAoCOAJ9hqHXadpGkXndVMsqMUXp9kYeHxACfceq2 |
| 68 |
NVeEVTn/BkgWExdHopsrkLU= |
| 69 |
=GpFz |
| 70 |
-----END PGP SIGNATURE----- |
| 71 |
-- |
| 72 |
gentoo-dev@g.o mailing list |
Archives