Re: faq.xml.qna

Sean Wheller <[email protected]> Fri, 6 May 2005 22:24:47 +0200
Newsgroups gmane.editors.conglomerate.devel
Organization In Words
Message-ID <[email protected]>
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,

Docbook qanda used to create FAQs is not suppored by Yelp.

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.

Hope this helps.
-- 
Sean Wheller
Technical Author
[email protected]
084-854-9408
http://www.inwords.co.za
Registered Linux User #375355

_______________________________________________
Conglomerate-devel mailing list
[email protected]
http://lists.copyleft.no/mailman/listinfo/conglomerate-devel
signature.asc (application/pgp-signature, 189 B)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)

iD8DBQBCe9KT9PtDMvDDTqYRAgEZAJ4jFzdfGzohcVhpgoNrTmV+TdyfJACfXPsY
FvH4OZrH0EQ70rtM5acUxoA=
=RlCE
-----END PGP SIGNATURE-----