Re: Canonical jhbuild documentation

[Frederic Peters <fpeters gnome org>]

Allan Day wrote:

> People will always come across the official manual on
> developer.gnome.org, since this ranks highly in search results. So, if
> you really want people to easily find the introductory documentation,
> it will have to live as a part of the official manual. I get the

The most important thing about the manual that lives in the jhbuild
git repository it that it can be translated (currently it's almost
fully available in Spanish, Portuguese (_BR), Greek and Japanese).


> impression that there has been resistance to this in the past, due to
> the desire to keep Jhbuild as a somewhat generic tool. However, I
> don't see how the two use cases (Jhbuild for new GNOME contributors,
> and Jhbuild for everyone else) couldn't be satisfied by structuring
> the manual according to audience.

I believe this is no longer a problem; when I tried to merge the
by-then new "BuildGnome" page into the manual, and converting it to
Mallard, the primary problem was of license incompatibility between
the contents from the wiki and the existing manual.

It would be nice if somebody could contact the authors:
  James Henstridge <james at jamesh.id.au>
  C.J. Adams-Collier <cjcollier at colliertech.org>
  Frederic Peters (ok, done)
  David Turner (Cillian64, from GHOP, back in 2007/2008, I can't
                find an email)

Btw the draft integration/conversion is still available at:
  https://people.gnome.org/~fpeters/jhbuild-mallard/


        Fred