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.


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?


Aer Lingus inflight entertainment system boot

I only managed to capture some of this as it booted, interesting to note the SD card use and the number of errors being reported. I haven’t found much out about the underlying system itself


Two more shots below


Working on my LXC Networking setup

Update (03/01/13): the diagram below is hopelessly wrong in regard to the networking for the ‘backend’ containers. I’m leaving the post as is as a reminder of how I worked through the setup. Will add a link here in future when I get the setup right. I’m currently setting up a [> Update (03/01/13): the diagram below is hopelessly wrong in regard to the networking for the ‘backend’ containers.


FaceTime problem on MacBook Pro 1.83GHz

I’m currently upgrading my sister’s 1.83GHz Core Duo MacBook Pro so that it can be handed on to our Mum, now that Jeanna has her shiny new MacBook Air (both at healthy discounts from Apple refurb stock). One of the reasons for handing this on is the built in camera which would allow us to use FaceTime. Thankfully FaceTime is available on OS X 10.6.6 and this MBP supports a maximum of 10.


Good data management

The project I’m working for currently is about data in the context of a regulatory framework. As part of that I come across interesting articles from time to time. While the industry domain is insurance there’s some good stuff in here about data. Have a look at the presentations over on the BCS.org (British Computer Society) Data Management Specialist Group subsite. Dean Buckner’s is particularly interesting. Haven’t had a chance to listen to the audio yet, just ran through the presentation.


Could we crowdsource a financial institution?

So this is a bit off the wall I’ll admit but I’ll throw it out there anyway. If you want to call it crazy, do :) I’ve deliberately not analysed this in depth as just throwing the idea around is making me smile.

We know banks here in Ireland are basically fucked and as both the effective owners and the customers we’re getting a raw deal. Even without the banking crisis the service we get is poor. The banks haven’t really been about banking as a retail service for a long time. It’s one of the reasons we see so much disruptive movement in the payment space these days (obligatory nod to Stripe :) ) – it’s just one of the functions of a bank that can be done better and the banks simply haven’t bothered. Services like Kickstarter and Fund it show that you can crowdsource money for useful and interesting projects. Credit Unions are basically operated on the same principle :


Mahon Tribunal Report

It seems difficult to reach the website for this, so here it is: Mahon Tribunal Report (PDF 56Mb)

Android foray: Arnova 8 G2

I have been threatening to get a tablet for awhile. Of course, as one might expect, an iPad has been the object of desire. This remains the case but not because I see this Android experience as a failure. Using a tablet has proven the tablet form factor for me. Even though I’m pecking this out on a soft keyboard which leaves a lot to be desired. Part of that’s probably due to the compromises that brought this €175 price tag. I accept that. The smart text that accompanies my typing just doesn’t seem as smart as on iOS which is down to UX design. It’s good but just not there yet. As an example, typing this I miss the space bar a lot and would expect that to be handled but it isn’t. There’s a good blog post by Benjamin Tseng doing the rounds on Twitter today (actually it was ages ago as I’ve been slow to get this finished). It talks about text and cursor selection positioning on Android versus iOS where the author prefers Android but I’m just not finding that same experience. Again, some of that is probably down to the capacitive screen and so not an entirely fair comparison. It’s enough of a pain in the arse that I’m now completing this, quite sometime after first starting this post, on a laptop.


Previous Page 2 of 24 Next Page