one man writes
one man designs
one man blogs
one man tales

Archive of This Site posts

 
 

On not blogging

A product release is imminent.

A trip to visit two customers in the US of A.

Ongoing complications with the new ISTC website (soon, soon!).

Planning for 2012, including a major restructure of our content.

Actual writing some documentation (a rare occurrence!).

Plus all the usual things that life is wont to throw at us.

Maybe look for me on Twitter instead?

How rude

There is one thing I haven’t done here for quite a while. It’s rather remiss of me so please accept my apologies.

Quite simply, I wanted to say thank you. To you. Yes YOU.

Thank you for visiting this blog, and more importantly, thank you for coming back and visiting again. A lot of the ideas I talk about here are made better by your comments, and I continue to find blogging to be a useful way to work through some of the thoughts and random ponderings that float around in my head.

I tend, like many, to do most of my blog reading through RSS and I know that making the effort to comment on a blog is something that not everyone will do, and which some blogs can struggle with. It continues to amaze and delight me that anyone reads this blog, let alone takes the time to share their own hard-earned thoughts.

So, sincerely, thank you.

Not written, yet

Quite a lot going on at the moment, but don’t worry dear blog reader I’ve not forgotten about you, I’ve still got plenty of things to post here just not really finding the time (or requisite brain power) to focus on them and think them through properly.

Here are some of the things I’ve started to write about but not yet posted.

In other words, “here are the posts languishing in DRAFT”.

  • Content from the ISTC and STC publications, why isn’t it all free?
  • Social Media Models, where I try and outline what I think are the models that we, as technical communicators can get the most value from adopting
  • The evils of presumption
  • Embracing user-generated content
  • Small social media. If your ‘community’ is very small, what will work for you?
  • How to stop thinking about documents

I will hopefully revisit some (all?) of these in the future, but before all that I have an eSeminar to prepare for, more details on that soon.

Present and Future

As we roll into the holiday season, I’m going to be pausing this blog until the New Year. I’ve found it tricky at times to get into a regular posting schedule here, so that’s something I’m hoping to rectify in 2010.

Looking back it’s been a good year for me, and I’m hoping to take a lot of things forward in the coming year. All of that will be covered here, of course, and I’ve got some plans to revisit some of the topics that I’ve shared with you this year.

Rather than write up a review I thought I’d just see what Wordle thought of my website, which is interesting in and of itself:

wordle

Thanks to everyone who has commented or emailed me direct. It has really helped me and I hope it’s helped some of you.

All the very best for the coming holiday season, and here’s to a wonderful 2010!

Guest Posting

A few weeks ago Scott, from the always relevant DMN Communications blog asked me if I’d be interested in writing a guest post.

I immediately said yes then, after a short pause, I set the expectation that I wouldn’t be able to write one for a few weeks as I was coming to the end of a project.

So, last week I finished off my guest post and I’m now waiting, somewhat nervously, to see how it will be received. The post goes live on Wednesday, so not long left to find out.

It’s quite liberating, writing a blog post for another website (not done that for years), and it sparked a few ideas for this place as well. You’ll start to see some of those soon.

Thanks to Scott for the opportunity, and keep your eyes peeled to the DMN Communications blog on Wednesday.

Helter Skelter

Helter Skelter

When I get to the bottom
I go back to the top of the slide
Where I stop and turn
and I go for a ride
Till I get to the bottom and I see you again!!!!

Ever get that feeling that you’ve been here before?

I write this blog post with haste as I’m halfway through the penultimate week of a particularly arduous project. Not only are we releasing a new version of the product, but we are completing the first major stage of our move to Author-it.

Overall the migration has been pretty painless. There are still some Word templates issues to work around and getting to grips with Variants has still to be tackled, but overall we are pretty happy with our choice. The only major gripe we have is partly our (ok, MY) own fault, and it’s here that I’ll offer the most valuable tip I can.

If you are migrating legacy content to Author-it (we were moving from Structured FrameMaker), make sure you thoroughly test and check the import settings. Time constraints had me rush this stage and we ended up paying for it, spending far too long cleaning up rogue topics than we had planned. Every cloud has a silver lining though, and it does mean that the documentation is now far more consistently written and styled than it had been. However, going through some 5000 odd topics by hand wasn’t the greatest use of our time!

Soon we will be looking to how we can leverage the output to provide better access to information, feeding into the developer community website we have already built, and improving how we deliver information alongwith our product set.

For the former we have taken some inspiration from the presentation by Rachel Potts and Brian Harris (Red Gate Software) at last years UA Conference, titled Delivering Help in a Support Portal. For our implementation the Publications team will take the lead, and it’ll be interesting to see where it takes us. Web 2.0, anyone?

We will also be looking to provide better online help by introducing Keystone Topics, as suggested by Matthew Ellison. Author-it should make these topics, which are the first topics the user lands on when they start the online help and which provide sensible links to common information (rather than just providing repurposed user manuals), very easy to build.

Two of the team will be in Cardiff for the conference this year so it’ll be interesting to see what we learn there and how we can really start to leverage Author-it in more and more powerful ways. I’m definitely keen to start innovating what we do and, in a few weeks time, we won’t have any further barriers to stop us.

Lengua española

Para el momento en que usted leyera esto, I’ el ll se esté asoleando en España.

Apologies for my butchery of the Spanish language for, despite visiting my father-in-law once or twice a year, I’ve yet to pick up much of the language. It’s lazy of me I guess, and if I’m honest I’m surprised that I’m not more interested.

But, considering language and grammar are fundamental to my job perhaps there is a small part of my brain that would really just like to switch off from all of that for a while.

So I’m jetting off to Spain for a week of sun, reading novels, drinking cold beer and generally doing not a whole lot. I’ll be trying NOT to think about the remaining 600-odd Author-it topics that still need tidied up, the entity definitions I’ll need to write when I return, the Javahelp landing pages which are still to be designed and build, Word template hacks, architectural overviews and more.

Back in a bit!