Proposed road map for ubuntu-docs

Jeremy Bicha jbicha at
Sat Apr 29 02:27:32 UTC 2017

On Fri, Apr 28, 2017 at 7:01 PM, Gunnar Hjalmarsson <gunnarhj at> wrote:
> Would there be a middle way? I don't know.

Thanks for giving more specifics about the differences in the Ubuntu
docs you see as being potentially valuable.

After reading it, this is my initial thinking (or proposal I guess):

1. Ubuntu would ship gnome-user-docs
2. Ubuntu could also provide an ubuntu-docs package that injects pages
into the existing gnome-user-docs framework. The Mallard format is
designed to allow extra content to be added like this (it's how
gnome-getting-started-docs works).
3. If we have to make changes to pages instead of adding new pages, we
could just modify the debian/rules for gnome-user-docs to not install
those specific pages. Then we just fork the page in ubuntu-docs. We
could do the same thing if we wanted to replace some of the pictures.

I think there are some benefits to not using patches for #3.
- Ubuntu and GNOME could share the same translations for gnome-user-docs
- I think it would be easier for the Docs team to work on regular help
pages rather than having to deal with modifying distro patches.

One more optional idea:
What do you think about converting the ubuntu-docs from bzr to git?
Since the Ubuntu Docs team should be submitting many changes to GNOME
directly now, I am thinking it would be easier for new contributors to
only need to learn one version control system instead of two. Would
switching to git be a problem for the existing team?

Jeremy Bicha

More information about the ubuntu-doc mailing list