So, we’ll need a modeling program, and we should probably just choose a single one which we can all use. Gaphor is a clean and simple UML modeling program for GNOME. It is, naturally, free software, released under the GNU GPL. It’s written in Python, is easy enough to install and very easy to use. It supports class, sequence and communication diagrams: the main diagrams we’ll be interested in.

It also produces nice, sharp, easy-to-read diagrams which can be exported to SVG or PNG.

It also has a plugin system (and docs to help you write new plugins) if we ever need extra features. If I could magically add a major feature, it would be a plugin to allow collaborative editing of models (rather like Gobby does with source files). In the mean time, we can just push gaphor files around via Jabber file transfer and use chat to discuss the changes we’re making. The gaphor file format is stable and XML-based (so it can be stored in subversion).

Like the ISBN example above, I’m going to be coming up with a few design sketches to suggest how various parts of Alexandria’s domain might be modeled. But they’re just preliminary ideas; we need to make sure that our eventual model matches the use cases rather than the other way around.