Re: Idea: each FAQ as its own xml file

On Tue, Aug 17, 2004 at 02:33:02AM +0200, Mich?le Garoche wrote:
> Le 17 ao?t 2004, ? 2:18, Daniel Macks a ?crit :
> 
> >I just looked at our translations of the Fink FAQ, and it looks like
> >some languages have fallen behind. In trying to sort it all out, I
> >became frustrated with the current source (.xml) file layout: each FAQ
> >entry is really a self-contained item that may be changed (or added or
> >removed), but we only have a single source file for the whole
> >FAQ. Would it be better to have each as a separate file (which the
> >build system joins together)? That way when committing a change, it is
> >clear which FAQ item was updated and one could note that "this
> >corresponds to english rev 1.38" to make it easy to keep things in
> >sync. This cannot be done now, because a single new revision could
> >involve many changed FAQs. It might be easy for some to be translated
> >quickly, but not others, but keeping track of corresponding revision
> >numbers requires knowing that they are all done.
>
> And how do you deal with faq referring to another faq, when one of them 
> is removed or renamed or merged if you split the faq in chunks?

Same way we do now: by <chapter> and <faqentry> "name=" attribute.

> The problem is not faq, the problem is to find people who can spend as 
> many time as it is required within a short delay to translate the whole 
> thing (not only faq).

Exactly. That's I proposed this...to make it easier to see what needs
to be done, and make the task seem less intimidating (small units,
instead of a giant file). It seems easier to organize "this-language
now corresponds to the current that-language" than to keep track of
which "[translate] ..." emails have been dealt with.

dan

-- 
Daniel Macks
[email protected]
http://www.netspace.org/~dmacks



-------------------------------------------------------
SF.Net email is sponsored by Shop4tech.com-Lowest price on Blank Media
100pk Sonic DVD-R 4x for only $29 -100pk Sonic DVD+R for only $33
Save 50% off Retail on Ink & Toner - Free Shipping and Free Gift.
http://www.shop4tech.com/z/Inkjet_Cartridges/9_108_r285