web analytics

Example for Dexy & Asciidoctor

In the post Dexy & Asciidoc(tor): A Business Analyst’s documentation tool to look at I went through how I’m using the two tools at the moment. I promised to provide an example within a few days but this has turned into a month now. Anyway, attached this post are the HTML (image not included, you’ll need the ZIP) and PDF outputs along with the full Dexy ‘project’. The content is in a Gitlab git repository.


Dexy & Asciidoc(tor): A Business Analyst’s documentation tool to look at

Like many a BA, I get cranky with Microsoft Word as a tool for writing requirements specification documents. ‘Track Changes’ functionality isn’t version control and very quickly becomes unwieldy. I also find that document formatting behaves inconsistently when you get into different sets of section formatting, even when you try to bend numbered lists to your will. I’ve also used IBM’s Rational DOORS in the past for documenting requirements and you get used to that idea of structured editing and establishing relationships between requirements. So, I decided one evening that I’d go to good old plain text and use a markup language for formatting so that I could have absolute control over my documentation.

which led to

Off I went with "What is dexy?" and the bit that stood out for me was:

Dexy makes it easier to create technical documents by doing the repetitive parts for you. Dexy provides a consistent interface to tools and scripts so you don’t have to run them manually. Your project’s dexy configuration keeps track of what to run, in which order, and with what parameters. This way, your whole process is captured so anyone can run it using one simple command and the results will be consistent.

Continue Reading


My 5@5

I meant to post this awhile back. At SkillPages we used to have a weekly 5@5 where one of the team played 5 tracks at 5pm on a Friday evening. I chose EDM as the theme of my selection and had a struggle to pick 5 that I think are classics. I ended up leaving out the Prodigy which I’m still unhappy about :) Anyway, here they are;

Name Artist Album
Feeling So Real Moby Everything Is Wrong
Dr Who? (2004) Orbital Live at Glastonbury 1994-2004
Bits + Pieces (7″ Edit) Artemesia Bits + Pieces
Rez Underworld Underworld 1992-2002
We Will Survive (Club Mix) Warp Brothers The Annual Spring 2001 (Disc 2)