Re: faq.xml.qna

Le 6 mai 2005 à 22:24, Sean Wheller a écrit :

> On Friday 06 May 2005 21:34, Michèle Garoche wrote:
>
>> Le 27 avr. 2005 à 21:04, Sean Wheller a écrit :
>>
>>> On Wednesday 27 April 2005 21:13, David Malcolm wrote:
>>>
>>>>> Question, do we want FAQ in the user manual? It is not  
>>>>> customary at
>>>>> GNOME.
>>>>>
>>
>> The problem I reported was that first the help menu does not work on
>> Mac, not related to conglomerate, but to the gnome help which has
>> hard-coded the path, hence there is no possibility to access the
>> files. Second that nobody knows that there is a faq, hence there is
>> no chance that the user sees it. That's why I suggested to
>> incorporate it in the faq and supplied a working patch for it, which
>> was rejected for reasons I cannot understand. Then a new not working
>> patch was supplied and accepted for reasons I cannot understand  
>> either.
>>
>> So that now the faq is still outside of the manual, which was not the
>> goal and did not compile since it relies on a local stylesheet.
>>
>> So that now I cannot even compile conglomerate, unless I supply
>> another patch, will will presumably also be rejected, etc.
>>
>> Feel like I don't have fun to work like this. Even less be flamed by
>> people who did not even try the patches, before rejected them.
>>
>
> Hello Michele,
Hello Sean,

>
> Docbook qanda used to create FAQs is not suppored by Yelp.
I know that, that was I supplied a patch which transformed the faq in  
mere article, but it was rejected for the reason that the source is  
the same for doc source and web site, which I can understand, but  
still does not solve the problem.

For you to better understand, I say again what I've said:
1 - menu help does not work on mac
2 - hence I should tell the fink users to use yelp
3 - therefore doc should work with yelp
4 - mac users are not used to navigate their trees to find doc for a  
package in a folder most are not even aware of
5 - thus there are three solutions:
      a  - conglomerate team does not bother that mac users had  
access to faq: leave it as it was before the patch be applied
      b -  faq is accessible via a new faq item in the about menu;  
which points to the faq on the web site
      c -  faq in either article format (easy to implement, that  
corresponds to the patch I supply) or quandaset (not easy to  
implement and the current patch is wrong for it to work correctly) is  
integrated in the manual
6 - In all cases, something needs to be done
7 - Till this is done, I can no more do anything

>
> I think that the FAQ is still a valid document format, but not for  
> Yelp. The
> FAQ should be transformed to X/HTML and copied to the Web Site.  
> Thinking of
> this I think it should be in the web src not the app doc src.
In this case, a new menu item in the about menu should be  
implemented, so that users know there is a faq.

Cheers,
Michèle
<http://micmacfr.homeunix.org>