Proposal to use meinproc for Kubuntu
matthew.east.ubuntu at breathe.com
matthew.east.ubuntu at breathe.com
Wed Nov 23 22:59:01 UTC 2005
Sean Wheller writes:
> On Wednesday 23 November 2005 11:44, Bhuvaneswaran wrote:
>> I've prepared a following proposal to change our build system for Kubuntu:
>> https://wiki.ubuntu.com/DocteamKubuntu
>
> This proposal makes absolute sense and was the intended furture direction. The
> only reason docs adopted xsltproc was because it was part of GNOME and it was
> easier to get people who were working on the GNOME Ubuntu, to use the GNOME
> toolchain.
>
> When Kubuntu was added to the doc portfolio it was just easy or a reduced
> learning curve.
>
> However, now that more people are working on Kubuntu I would suggest a move
> toward mienproc since it would mean better integration with the build
> environment for kde and kde-docs in general. While doing this I would also
> recommend reverting translation tools, for Kubuntu, back to those supplied by
> kdesdk
I still don't see _why_ integration with the kde-docs build environment is
necessary. AFAICS the end result is identical. Problems I see with adopting
meinproc for kubuntu and xsltproc for gnome (partly repetition of previous
email):
* doing some docs with xincludes, and others without will increase the entry
barrier and confusion for contributors who wish to work on both ubuntu and
kubuntu
* having different build systems will make for more difficult and greater
maintenance
* generally, fragmenting the team effort without an identifiable reason
(although I will be pleased if someone points this out)
In fact, I think it is more important that integration between ubuntu and
kubuntu documentation is achieved, rather than integration with upstream. We
are limited to a certain extent by the readers, but I don't see why our
online documentation should use different technology.
As for translation, the idea of using two different translation build
systems I really find just baffling, especially since I know full well that
we are short staffed and will probably not have the time to grapple with
separate systems (the past two releases have taught me that). Again, I see
no good reason.
Matt
More information about the ubuntu-doc
mailing list