If you met me at a conference recently, you probably got one of my very dexy business cards. I love the idea of business cards which are useful in some way, and these are business cards which are also mini demos of Dexy, not to mention the awesomeness of having business cards with source code!
I’m down to the very last card of my first order from Moo (except for the 4 I’m keeping for myself – 1 of each design), so as I’m about to order more, it occurred to me that I haven’t actually blogged about them yet. To make up for this omission, I made the first Dexy screencast talking about how the cards are made.
I have recently been playing with Riak, a key-value store database inspired by dynamo, and in particular with its map-reduce functionality. This gave me a nice excuse to write this blog post which describes the Python interface to Riak, and also demonstrates how Dexy can be used to run and document map reduce jobs and to make use of the returned data.
When I was thinking about the best option for community support for Dexy, I decided to take the forum route rather than the mailing list option. After much searching, I chose Vanilla Forums which was open source and seemed pleasant to interact with and sanely written. You can visit the Dexy forum at discuss.dexy.it.
Recently, since I had a question to answer and wanted to be able to do so using Dexy, I sat down to implement Dexy integration with Vanilla. As a result I developed two filters, one called ‘vanilla’ for starting a new discussion, and one called ‘vanillacomment’ for commenting on an existing discussion (i.e. answering a question).
If you are interested in learning Dexy, while also contributing to an open source project, and having a fun day out with fellow geeks, then here is your chance! There will be a documentation hack day on Saturday, 26 March 2011 at the TOG Hackerspace in Dublin. This will be a hands-on hack day where we will be writing real documentation, so it’s a great chance to learn-by-doing. It’s absolutely free and will be lots of fun!
You don’t have to be an expert programmer, but you should be comfortable with the command line and have some programming experience. The signup form is here. If you have any questions feel free to leave them in the comments or contact me. The hack day will start at 10am, go until 5pm (or thereabouts).
Let’s look at an example of what we can do with our newly liberated JavaDocs. Because we can make use of the JavaDoc information elsewhere, we can combine this information with other sources. This means that we no longer have to use JavaDoc comments for everything, we can just use them for what they are good at and place other types of information elsewhere. A great candidate for this is mathematical descriptions of formulas that are being implemented with code. I have been looking into this as part of my work for OpenGamma, who have a lot of math to document.