Mailinglist Archive: opensuse (4393 mails)
| < Previous | Next > |
Unofficial FAQ Update
- From: Togan Muftuoglu <toganm@xxxxxxxxxxxx>
- Date: Fri, 23 Nov 2001 16:23:47 +0200
- Message-id: <20011123162347.A21216@xxxxxxxxxxxx>
Hi,
First Happy Thanksgiving to all Americans on the list.
Well I had some free time and I did some additions to the UNoffical FAQ.
The main change is the layout and how it is done (hint thereis an
explanation of this in the apeendix section of the FAQ). Suggestions
comments in improving the layout is appreciated.
The layout is currently as suggested by James Oagley.
The following part suggested by Volker Kuhlman and what I can do at
the time being as follows, you can call it a TODO list
* Volker Kuhlmann; <kuhlmav@xxxxxxxxxxxxxxxxxxxxx> on 20 Nov, 2001 wrote:
> Some suggestions:
> 1) Stay with the format of the SDB. It works well. Use different headings
> in the problem/applies-to/solution parts as appropriate. One file per
> problem.
Well this I have to work on. Curently I have limited knowledge of
Docbook DTD and there are some limitations of it as well. Currently I
can only chunk at section level until I find a method to chunk per Q&A
set keeping the ratio one file /one problem is difficult.
>
> 2) It is absolutely essential to record the versions for which the
> solution applies or was tested on. See the SDB - without at least the
> SuSE versions it would only be half as useful.
This part needs some redesign and the current way I do it seems like it
would be possible, yet not done yet
>
> 3) Use htdig.
a) computer on which http://dinamizm.ath.cx is currently needs a heavy
upgrade (its'a 486/66 24 MB with a total of 400 MB harddisk and I am afraid htdig
needs more space. (hint that's why there is mirror
http://toganm.tripod.com )
b) Nevertheless the way every section is done there are META TAGS with
keywords so hopefully someone who will be mirroring the FAQ if has
htdig search by keywords is possible (AFAIK yet not tested, if the
methodology of htdig is different than tell me what it needs in the html
output)
>
> 4) Integrate with the SuSE help system. It's absolutely excellent. In
> this case, 3) is a must. I could assist with making rpms for this.
idea is great so couldbe on the TODO list (towards the end maybe )
>
> 5) It might pay to record name and email of the person who wrote the
> entry for the FAQ, for further issues turning up.
With the current layout although this is possible
a) I do not want to put emails on the html
i) not to help email-addrress collectors
ii) may be the person does not want to receive prive questions
which could have been send to teh mail list
b) I have the answer for preventing item "i" of above but incorprating
that would be possible later, since working with 20.000 mails have its
presents anyway.
--
Togan Muftuoglu
First Happy Thanksgiving to all Americans on the list.
Well I had some free time and I did some additions to the UNoffical FAQ.
The main change is the layout and how it is done (hint thereis an
explanation of this in the apeendix section of the FAQ). Suggestions
comments in improving the layout is appreciated.
The layout is currently as suggested by James Oagley.
The following part suggested by Volker Kuhlman and what I can do at
the time being as follows, you can call it a TODO list
* Volker Kuhlmann; <kuhlmav@xxxxxxxxxxxxxxxxxxxxx> on 20 Nov, 2001 wrote:
> Some suggestions:
> 1) Stay with the format of the SDB. It works well. Use different headings
> in the problem/applies-to/solution parts as appropriate. One file per
> problem.
Well this I have to work on. Curently I have limited knowledge of
Docbook DTD and there are some limitations of it as well. Currently I
can only chunk at section level until I find a method to chunk per Q&A
set keeping the ratio one file /one problem is difficult.
>
> 2) It is absolutely essential to record the versions for which the
> solution applies or was tested on. See the SDB - without at least the
> SuSE versions it would only be half as useful.
This part needs some redesign and the current way I do it seems like it
would be possible, yet not done yet
>
> 3) Use htdig.
a) computer on which http://dinamizm.ath.cx is currently needs a heavy
upgrade (its'a 486/66 24 MB with a total of 400 MB harddisk and I am afraid htdig
needs more space. (hint that's why there is mirror
http://toganm.tripod.com )
b) Nevertheless the way every section is done there are META TAGS with
keywords so hopefully someone who will be mirroring the FAQ if has
htdig search by keywords is possible (AFAIK yet not tested, if the
methodology of htdig is different than tell me what it needs in the html
output)
>
> 4) Integrate with the SuSE help system. It's absolutely excellent. In
> this case, 3) is a must. I could assist with making rpms for this.
idea is great so couldbe on the TODO list (towards the end maybe )
>
> 5) It might pay to record name and email of the person who wrote the
> entry for the FAQ, for further issues turning up.
With the current layout although this is possible
a) I do not want to put emails on the html
i) not to help email-addrress collectors
ii) may be the person does not want to receive prive questions
which could have been send to teh mail list
b) I have the answer for preventing item "i" of above but incorprating
that would be possible later, since working with 20.000 mails have its
presents anyway.
--
Togan Muftuoglu
| < Previous | Next > |