Proposed road map for ubuntu-docs
jbicha at ubuntu.com
Sat Apr 29 02:27:32 UTC 2017
On Fri, Apr 28, 2017 at 7:01 PM, Gunnar Hjalmarsson <gunnarhj at ubuntu.com> 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
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?
More information about the ubuntu-doc