Re: faq.xml.qna, yelp doesn't handle QandA

David Malcolm <[email protected]> Mon, 09 May 2005 13:13:14 -0400
Newsgroups gmane.editors.conglomerate.devel
Message-ID <[email protected]>
On Sun, 2005-05-08 at 17:20 +0200, Sean Wheller wrote:
> On Sunday 08 May 2005 16:59, Geert Stappers wrote:
> > That will start a bugreport, severity enhencement, on yelp.
> >
> > Dave did ask us to do so.
> >
> > Don't count on me for that one.
> > Where we all have our own buzy schedule with somewhere time for
> > Conglomerate. Do we all have our reasons for not reporting the yelp
> > enhencement. Mine are that "I broke my nose when I dived into gtkdoc",
> > I have no appateit for diving in other Conglomerate related technology.
> 
> I spoke to Shaunm the Yelp maintainer. The GDP have no plans to add support 
> for qanda to yelp. They add support only for what the GDP needs. Since qanda 
> is not a need at GDP and nearly no projects supply a faq, they have little 
> motivation to add this support to yelp. I can understand there reasoning.

Thanks for this information.  I believe Shaun is totally swamped with
GDP work, so it seems fair enough for him to want to restrict coverage.

> 
> What I think is that we should not package FAQ with conglomerate. Only put the 
> FAQ on the Web Site.
> 
> If we must package the FAQ then lets add a transformation to the cong build 
> and ship a html file instead.

So we have a separate DocBook XML file for the FAQ, which gets
transformed to HTML, and we stick it on the website and as in the
tarball?  This sounds like a good way forward to me.

> 
> The user manual remains as XML.

i.e. we ship it as XML, and yelp does the transformation "on the fly"?
Sounds good to me.