migration of ubuntu-docs to bzr?

Jonathan Jesse jjesse at iserv.net
Mon May 28 00:34:10 UTC 2007


I think this converstation comes up every new release, but what is the team's 
thoughts about moving to bzr and away from subversion.

I have recently started to work on both the Keep documentation and (yes again) 
the documentation for Adept, with a focus on the differences between 
Kubuntu's version of Adept and KDE's version.  So in my mind there will be 
multiple versions of the documentation.

Anyways, I've spent a lot of time working on Keep documenation and it is 
currently maintained in bzr and then launchpad.  Please see 
http://bazaar.launchpad.net/~jjesse/keep/keep-doc1 for the actual bzr branch.  
Also check out http://codebrowse.launchpad.net/~jjesse/keep/keep-doc1/changes 
to see a different view of the documentation that allows you to browse actual 
changes that I've been making.

Some benifits I see to using bzr and launchpad:
1.  Commit access is controlled by only allowing members of the team to upload 
to launchpad by setting the team as the owner of the branch.
2.  Notifications of changes to documentation can still happen by having 
people subscribed or subscribing the team and there can be different levels 
of subscription.
3.  One can browse the code and the changes in an easy to use way.  See 
earlier link to Keep documentation.  I think this was an earlier problem with 
migrating to bzr from subversion.
4.  No longer relying on RT for changes to passwords, etc...  I know the times 
that I've lost my password it has taken quite awhile to get a new password 
created with much hassle of the admins who deal with RT.  Now the person just 
needs to have an .ssh key uploaded to launchpad and be part of the team that 
can commit to the bzr branch.


I'm sure there are other reasons I could think of, but it has been quite easy 
to setup and maintain my own branch of documentation as I've been working on 
projects.  I would be quite interested as to what the rest of you thought 
about this.

Thanks,

Jonathan




More information about the ubuntu-doc mailing list