Ubuntu-Manual bzr Workflow

Asked by Greg Beam

Hello All,

I've done allot of searching, reading and digging on ubuntu-manual / bzr sites, but I've not been able to find the workflows for the ubuntu-manual project itself. In particular, I'm looking for documentation on the type of repo (I'm assuming it's decentralized), how ci and merges are performed, branching, is there a gatekeeper like PQM being employed if so how is that managed things of that sort.


Question information

English Edit question
Ubuntu Manual Edit question
Kevin Godby Edit question
Solved by:
Kevin Godby
Last query:
Last reply:
Revision history for this message
Best Kevin Godby (godbyk) said :

You can find an outline of our basic bzr workflow in chapter 3 of our style guide: <http://files.ubuntu-manual.org/style-guide.pdf>.

Generally, everyone just commits to the main branch. Each version of the manual (12.04, 12.10, 13.04, 13.10, etc.) has its own series and bzr branch. While we don't typically use merge proposals, you're welcome to if you prefer.

Currently our automatic build/CI system is offline. I'm hoping to get a new one in place soon.

There are no gatekeepers or PQM system per se. Once you've joined the Ubuntu Manual Team through Launchpad, you'll have direct commit access to the bzr repository. We monitor the repository for vandalism but haven't had any instances of it in the 2.5 years the project has existed.

If you have any further questions, please feel free to ask.

Revision history for this message
Greg Beam (ki7mt) said :

Hi Kevin,

Thanks for the info.

I downloaded the style-guide, will chew on that for a bit.

I just finished sorting out needed packages etc, then ran the build on Saucy and Raring. Both came out very nice. Can see Saucy needs some screen shots, so I may take a stab at that.

As for the workflows etc, I just wanted to understand how a system with many contributors works, as I know a couple projects that need just this sort of collaboration.

Thanks Again

Revision history for this message
Greg Beam (ki7mt) said :

Thanks Kevin Godby, that solved my question.

Revision history for this message
Kevin Godby (godbyk) said :

We wait to take all the screenshots after the UI freeze date. But if you find places in the manual where you think a screenshot would be helpful, feel free to let us know.