bookmark_borderWriting about writing on writing

I’m always one for the latest thing, particularly when it comes to social media. So when I heard the @Ev (the man behind Blogger and Twitter) had started up something new, I was quick to check it out.

His latest venture is called Medium. It’s an online writing space.

At least that’s part of what it is.

It’s a wonderful hybrid; an excellent online writing tool (which already makes writing this blog post in WordPress seem clunky), and a shared repository of posts and articles created using Medium.

It’s a lovely tool to use and speaks to the fact that, for many people, the act of writing needs a focus and space to be allowed to flourish. There are many applications that offer this, I use Byword heavily for this exact reason, but Medium is the best online writing tool I’ve come across yet.

It does leave me with a quandary. I write here, I am (heavily) invested in this blog, but I’ve also written something there – Writing on writing – which was a much nicer user experience. Can I merge the two?

Not yet, it seems, so I doubt I’ll use Medium much more until I can find a way to archive things here as well (there is an export option on Medium but I’d prefer it to be done automatically). I’d urge you to check it out though, it’s a lovely place to play.

Start here: What we’re trying to do with Medium.

bookmark_borderOn blog comments

I always get excited when I see an email in my inbox with a subject line that starts “WordPress:…” as it means someone has commented on one of my blogs. Such a simple delight I know but hey, you take pleasure in the little things I guess.

Sometimes that delight is instantly crushed when I realise it’s a spambot that is trying to add a comment containing a link to either some ‘enhancing’ pharamceutical, a flirty comment from a hot chick, or just complete nonsense accompanied by a phishing URL.

However there seems to be a rise in the number of “real” spam comments these days, and that is hugely disheartening. These comments are left by, it seems, real people who have taken a fraction of a second to search, for example, for “Olympics” found my blog post from a couple of years back and added in a perfectly unoffensive comment, with a link to their specialist Olympic Boxing in 2012 website.

And in a weird way that, to me, is worse than any automated spambot. The fact that there is (again, it certainly seems that there is) a real person that has left the comment makes the whole thing feel tainted and dirty.

Don’t get me wrong, I’m not hugely precious about this blog but really, this new development in comment spam is just ugly. But then it’s always the few that spoil it for the many.

bookmark_borderBest Post

For a while now I’ve been meaning to update the About page of this blog. Ideally I’d like to put a short list of the ‘best’ posts from this blog.

Trouble is, whilst I’m quite happy to choose the list myself, it’s sort of tricky to find them, I mean seriously, there is a LOT of crap in here.

I would use the number of comments as an indicator but, having only switched to WordPress a couple of years ago and deciding then (foolishly) that I wouldn’t bother migrating all the old comments over, I’m a bit stuck.

Dare I ask my readers to help out?

Would any of them be able to list one ‘best’ post, let alone three??

Only one way to find out I guess.

I’m away all of next week so don’t worry, you don’t have to rush, but if any of you feel so inclined, I’d love to hear what you, dear reader, consider to be the top posts on this here blog.

bookmark_borderUA Conference Notes – Day 1

Notes and thoughts from Day 1 of the User Assistance Conference

Session 1 – Tony Self – Emerging Help Delivery Technologies
It’s been quite a while since I heard Tony speak but as ever he provided an entertaining, if somewhat limited, presentation. Covering the various types of help viewing technologies he nicely summarised some of the available choices including the features to look out for, including the ability to wrap up an online help system in its own application (using technology like Adobe AIR). It was interesting to hear some Web 2.0 features making their way into online help technologies, including voting and commenting facilities which would give you direct feedback from the people using your help system.

Session 2 – Joe Welinske – Write Mote, Write Less
Embracing the Value of Crafted Words and Images
Another regular speaker and Joe was certainly fired up, challenging us all from the outset of his presentation to consider how we work in far more detail than we currently do. First up he suggests that we should be writing fewer words whilst making sure those words are correct and so lessen the impact on the reader, providing just the information they need and nothing more.

And then he hit on something that I’ve previously mentioned here (although Joe nailed it much better than I did), namely allocating writing resource to the highest priority pieces of documentation work, rather than the traditional approach of documenting everything. It’s a simple approach that, when combined with better writing, leads the craft of technical communications to provide much higher value to the business which is good news for all of us.

Session 3 – Sonia Fuga – DITA & WordPress Solution for Flexible User Assistance
A showcase style presentation of a stunningly simple concept. With a little bit of coding work (building a DITA importer to get XML content into the WordPress database), the team at Northgate offer a web-based help system which allows users to add their own notes and to vote for useful information, and which is can receive updates with new content with each release.

How? By using WordPress features. Notes are left as comments, votes are left using a WordPress plugin, and the updateable content is controlled by only allowing the customer (who has access to the WordPress admin screen) to create Pages, leaving the Posts controlled by Northgate. I use WordPress for this website, and spoke to Sonia in the evening to confirm some of the finer details. It’s a very clever use of WordPress, and I hope Northgate release their DITA importer to the open source community!

Session 4 – Question and Rants
A short session with four speakers each giving a two minute ‘rant’ and then taking questions. Nothing particularly noteworthy came of this but it’s a good addition to the usual style of presentations and made for a little bit of light relief.

Session 5 – Dave Gash – True Separation of Content, Format, Structure and Behaviour
Another familiar name, Dave is always entertaining and a very dynamic speaker and in this session he even managed to make the somewhat mundane topics of HTML, CSS, and JavaScript interesting!

Outlining some basic principles he showed how you could take an HTML file, full of embedded behaviours (javascript), style rules (CSS), and content and strip out all four parts into a more manageable set of files. This way, holding the style and behaviours in referenced files, you can make changes to either and have them ‘ripple’ through all of your deliverable.

Admittedly this was all done by hand but the basic principles are something that you should be following if you have that kind of output.

Session 6 – Matthew Ellison – User-centred Design of Context-sensitive Help
Interesting presentation by Matthew which started a little slowly, covering the history of context-sensitive help before taking us onto the idea of task support clusters. Originally presented by Michael Hughes at the WritersUA conference, the premise is to offer the user a smarter landing page, referred to as Keystone Concept topics here.

The key to a successful Keystone Concept topic is not to limit what is presented, and to consider that it should be different depending on the context from which it was launched, with the ultimate aim of getting the user back on task as quickly as possible. This includes any form of tips and hints, and crucially suggests NOT to include the obvious stuff (don’t answer questions that users will never have!). This mirrors part of the theme from Joe’s talk early in the day, and certainly seems to be a sensible goal given the business (time and resource) pressures we are all under.

After that, I had a few beers and a chat with some other delegates, and as ever it was great to hear that most of us have similar issues, problems and solutions.

I’ll post my notes from Day 2 of the conference tomorrow.


What is it about these things, these events in life that all seem to collide. Days go by with only the merest ripple distorting the norm then … BLAMMO! …

For example, take tomorrow. I need to be in the office to deliver a presentation as part of our induction and the kitchen fitters are due to, finally, start work. I’ve also got an appointment with the nurse to get my blood pressure taken.

I’d figured out the timings, I’d wait until the kitchen fitters arrived and then head to work. The presentation is right after lunch, so I’d give that then head off to the local health centre, then home to see how the fitters are doing.

Except they won’t be here until midday apparently, which fucks up everything. I can’t NOT be in work tomorrow but can’t wait here until midday… so Louise is taking the day off.

It’s never simple, is it?

Mind you, fate sometimes helps. I’ve managed to bork the search page on my other blog, so when I heard WordPress 2.5 was out I figured I may as well grab it and get upgraded. So I have. Both blogs are now on 2.5 and the upgrade was super smooth and whilst I’ve not had much time to play with it, the new admin screens aren’t too bad.

Fate, sometimes it gives you a helping hand, sometimes it’s like a steel-toecapped boot to your knackers. Such is life.

In other news, isn’t the new R.E.M. album good! They’ve rediscovered loud rockin’ guitars, wheeeee.

bookmark_borderNo searching…

I’ve been trying, unsuccessfully, to add a better (Google) search to this site. Alas because I have a hand-coded WordPress theme, and I last looked at it about a year ago, I’ve managed to bork the search results location.

So, for now, the search isn’t working. Nuts.

Thanks to Tom, it’s all working now, and it’s even better!