Moving code to BitBucket

As the number of packages I’ve written has grown keeping a track of everything has got more complex for me. Not having a background in programming, I’ve very much had to learn things ‘on the job’. One thing I’ve been doing for a while now is using a version control system for the new version of siunitx and working as part of the LaTeX3 Project. The LaTeX3 Project uses the Subversion system (also known as ‘SVN’), and so I’ve been using the same system for siunitx version 2 (hosted by BerliOS). I’ve now decided to get a bit more systematic, using the service provided by BitBucket.

Aims

There are a few different things that I wanted to get sorted out with all of my packages. First, I think it is useful to make the code (and code changes) publicly available in one place. That is what version control systems provide: you get a list of changes, with hopefully some notes on what was going on. That also makes it possible for other people to easily suggest patches (if they want to, of course!). Second, tracking bugs and feature requests really requires some kind of structure. I currently have a long list of e-mails that list things to think about: making these both publicly available and organised is a good idea. That helps me, and also lets user see what has already been logged. Third, it is useful if there is a way of having on-line documentation, for example using a wiki.

Moving to BitBucket

I had a look at various approaches to doing all of that. I’ve had a few issues with BerliOS, and as I’ve used it I’ve realised that the interface is rather awkward. Two services which look rather more helpful are BitBucket and GitHub. Both of these are based around distributed version control systems: Mercurial and Git, respectively. I’m not going to go into the details of either of these (or the differences between them), but Mercurial seemed a bit easier to use to me so I decided to go that way. BitBucket includes all of the bug tracking and wiki features on my list of ideas, and so far I’ve found the interface clear and powerful.

Over the last couple of days I’ve uploaded basically all of the current versions of my packages to BitBucket. As most of these were written without formal version control, I’ve had to ‘reconstruct’ the historical changes from my archive. I’ve aimed for a balance between providing information and my time: the history goes back to the first version of the current releases (for example, from v3.0 for achemso, which is currently on v3.4f). Of course, any new versions will appear on BitBucket. I’m now working on moving all of the issues into the bug databases. I’ll also look at the wiki side of things: I’ll try to put some basic installation and use information, and perhaps some frequently asked questions. BitBucket includes RSS feeds, so anyone interested can follow what is going on.

The beamer connection

I should add that one of the reasons for looking at all of this was the recent news that the beamer package has a new maintainer. I’ve taken a bit of interest in this, and as the code has been moved to BitBucket, took a look at the facilities on offer there. As a result, I’ve been given access to the new repository. I have a few vague ideas about areas to look at, but at the moment nothing definite!

Get involved

Anyone interested is of course free to contribute. Adding any bugs, enhancements or ideas to the databases is one of the easiest way to do that. If anyone wants access to edit the wikis or add code, drop me a line.

2 thoughts on “Moving code to BitBucket

  1. This is great news!

    I got hooked on your package a couple months ago when trying to find a more elegant way to handle displaying units in my LaTeX documents. Your package solved my problems with units and a lot more concerning number formatting, alignment in tables, etc.

    I upgraded to siunitx version 2 when the first pre-release announcement was posted. I noticed a couple of bugs and attempted to create an account on BerliOS to submit bug reports but somehow I could not get BerliOS to send the confirmation email I needed to activate my account.

    The bug reports weren’t that critical- so I just gave up and found workarounds. Now with the move to Bitbucket I can easily submit issues.

    Thanks for this wonderful package and your decision to help people get involved with it’s development!

  2. Hello Charlie,

    As I said, I’ve had a few BerliOS issues myself, which in part prompted me to look elsewhere. There has been a lot of work of v2 on the way to the beta: Stefan Pinnow is a one-man bug-testing team! Please do note anything you find: as I say, my plan is to try to be a bit more professional and to have a bug listed for each issue, even if I immediately fix it.

Leave a Reply