Re: Canonical jhbuild documentation

On 10/02/2015, Frederic Peters <fpeters gnome org> wrote:
Allan Day wrote:

People will always come across the official manual on, 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.

The wiki is unlicensed as far as I can see from the pages and the "©
GNOME Project" notice is invalid as well. This is a long term problem
which will be challenging to fix, to say the least. The same jumping
through hoops will need to be done to move the content off the wiki as
you are doing for the old manual.

It would be nice if somebody could contact the authors:
  James Henstridge <james at>
  C.J. Adams-Collier <cjcollier at>
  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:

desktop-devel-list mailing list
desktop-devel-list gnome org

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]