Greetings and best wishes for the season
As we draw ever closer to the big day I wanted to fire off a greeting to all my fellow Technical Communicators. How to do this though? The followers of The RoboColum(n) are spread far and wide. Heck they may even speak many different languages. I hope the following goes some way to address things. Please fell free to correct any translations and I hope I haven’t insulted anyone
Out of office? Then please unsubscribe!
As the sun appears from behind the dark winter clouds and the green gauges on the trees in my garden start to ripen, I dare to believe that summer has actually arrived. It is at this time that we start planning that all important summer break. If you are in a similar position, please bear in mind one of my BIG gripes. Automated out of office replies!
The RoboColum(n): Crunchy & Smooth
Following on from my previous review of 2010, I received an email today from WordPress (The RoboColum(n)’s host platform) with a fairly nifty statistics summary. As users of WordPress will know, their usage statistics are pretty cool and are an excellent way to judge your blog’s health. There was a fair amount of detail in the summary, which I won’t bore you with, but the more interesting aspects are included below:
The crunchy stuff
In 2010 The RoboColum(n) saw:
- 70 new posts, growing the total archive of this blog to 171 posts.
- Top referring sites were:
- Users finding The RoboColum(n) via a search, searched mostly for:
- hh.dat
- mk:@msitstore
- robohelp cpd file
- chm security
- framemaker 10
- The most frequently viewed posts were:
- ÜberWrite. A new HAT for a new decade. April 2010
- RoboHelp 8 and the .CPD file February 2009
- The HH.DAT file April 2009
- RoboHelp Skin availability March 2009
- The Microsoft HTML Help API Commands August 2009
The smooth stuff
One of the most interesting and pleasing aspects of the above statistics is that only one of the frequently viewed posts was from 2010. What is more, the four that were from last year address specific issues faced by Technical Writers to this day, and not only users of Adobe software. They also demonstrate how social media has come to play a small but important part of my life, with referrals coming to The RoboColum(n) from both LinkedIn and Twitter.
Whilst I frequently look at my statistics, seeing the above in black and white highlights the areas with which Technical Writers find most problems. In 2011 I hope to focus more on these and other problem areas, as well as continue to post general tips and tricks on Adobe Technical Communication Suite products. 2011 will prove to be an exciting time for users of Adobe RoboHelp, Adobe FrameMaker, Adobe Captivate and Adobe Acrobat Pro and I hope that The RoboColum(n) will continue to be one of your portals of choice.
2010: Accolades, interactive docs & a death threat
As the dawn of 2010 disappears behind the late December dusk, I feel a retrospective look at what has come to pass is required. Call it being lazy if you will, although personally I’d disagree. It’s definitely not that I can’t think of anything else to blog about (you should see my “To blog about” list) it genuinely is that a lot has happened this year, including:
• Completing two major documentation projects to great acclaim.
• Increased exposure in the technical communication industry, particularly in Adobe circles.
• Blogging related accolades.
2010 started with delivery of a large rewrite of one of the company’s flagship product suites. The year long project involved a bottom up, top down and side to side revisiting of what we provided. As well as the design and look and feel, we focused on ensuring the deliverables had the correct generic information for the entire user base, together with specific use case examples. This was vital for an application that crosses different job functions.
For the first time we used simulations inside the help file to add some interaction and support the existing text. Critically we chose not to replace the help text with simulations, but use them only where they would add value (e.g. areas where the applications interface was a little ambiguous). The toil was well worthwhile as user feedback was very encouraging. Even one user known for his negativity sang our praises!
The results and feedback from this project were to figure several times throughout the year, largely as a result of my use of social media. This blog had been active since early 2009 and had built up a select subscriber base without reaching a massive audience. All of that was changed once I embraced sites like Twitter, LinkedIn and Facebook more strategically. In fact my online presence delivered many opportunities to both me and my company as the year wore on. A reason why all Technical Writers should start using (at least) Twitter.
First up came an offer from Adobe to produce a Use Case Study with their Marketing Department. As part of the documentation rewrite project we had implemented, we embraced the integration between the products in the Adobe Technical Communication Suite 2. We’d been Adobe RoboHelp users for a while and had used Adobe FrameMaker on occasions for specific deliverables, but had not used Adobe Captivate. The level of integration between the three applications, and the generous upgrade options, made the purchase of several suite licenses a no brainer. Additionally we had successfully implemented the Adobe RoboHelp Server 8 feedback analytics application, and were starting to reap the benefits of the statistics it provided. The experience of producing the use case study was an interesting one, not least because of the need to moderate some of the claims made in the initial copy! With the Marketing Department producing the copy following an initial conference call, the style of writing was very different to that used to write software help files. Still it was a worthwhile exercise which brought the company some free marketing.
Around the same time I started getting noticed inside the technical communications industry. I maintained an online presence with my peers and kept in touch with industry trends. I don’t spend much time on online, preferring to dip in and out when I have a few seconds. The TweetDeck Twitter client is an excellent way of allowing me to do this whilst focusing on keywords and users. Add to that, 15 minutes at home reviewing LinkedIn groups and my Facebook wall and that’s it. It need not take a lot of effort to do likewise. Invitations followed to write guest posts on various blogs. Wordtree Consulting, Concise Documentation and DMN Communications all saw the fruits of my craft. Alongside these brushes with minor celebrity I had three articles published in Communicator, the journal of the Institute of Scientific and Technical Communicators journal (ISTC).
In September I was invited to deliver a talk at the Technical Communications UK Conference in Oxford. Another opportunity that came my way via Adobe, this was a chance to tell the faithful about our use of the Technical Communication Suite 2 and RoboHelp Server 8. The three day conference was well organized, full of interesting / varied speakers and excellent value for money. It was also a great opportunity to network amongst fellow technical communicators, put faces to names and meet virtual friends in the flesh. I’d highly recommend any technical communicator to attend.
As the year came to a close, yet another big documentation project was delivered. The success of the last big project raised the bar to what was an acceptable deliverable. Plain text and occasional screen grabs were complimented with yet more simulations to support the text. We also threw in some example use case files that can be downloaded and imported into the application. Now you had a level of user assistance never seen before in our documentation. This brought the Technical Documentation team some welcome attention from other departments. It may not be rocket science to anyone reading this, but people started asking what we could do for them. Where do I start? I have a long list of things to get stuck into in 2011.
Away from the day job I managed to fit in a bit of contract work. Not much, but enough to fill in the odd few hours! Mostly this fell into my lap through my industry contacts. I’m not looking to move from my job but it helps to keep the iron in the fire in case circumstances change. The RoboColum(n) has gone from strength to strength with a loyal following and more regular interaction with subscribers. In the summer it was given the accolade by Mindtouch of being amongst the 25 most influencing technical communication blogs. Although you can pick through the metrics used, it was a major honor, especially as there were only 5 bloggers in the 25 from the UK. My aim now is to better my 15th position and reach the top ten in 2011. I’ve even found time to once again join the beta test team for Adobe RoboHelp 9 and Adobe Technical Communication Suite 3. However don’t ask me about a release date as a) I honestly don’t know b) can’t tell you even if I did c) would have to kill you if I digressed
.
So 2010 ends and 2011 starts. As our Managing Director told his top Salesman last week, “You may well be top dog this year but come January 1st you are back equal with the others.” I am truly grateful for all the opportunities and success that has come my way in 2010, but I am not complacent to what still needs to be achieved. There is a long way to go, but this is a sound platform with which to greet the New Year.
It has been a lot of fun and I hope you stick around for the ride. May I wish all my readers a very peaceful and joyous 2011.
Disk space / memory 1980s style!
Last week I bought an external disk drive. It isn’t particularly big in physical size or memory capacity but it fulfills all our current and future needs. At 500Gb it is more than the total capacity of my laptop’s hard drive and still have more than enough space to store source files and other assorted stuff from my work PC. It is also small enough to fit inside my shirt pocket.
I could have bought a larger external disk if I’d have wished. The standard entry point appeared to be 1.5 Tb with disk sizes going well beyond that. They weren’t much bigger in physical size either. The problem for me was that they needed an external power cable rather than running from a USB 2.0 port. As I was going to be using my drive on at least two PCs I just didn’t want the have to be plugging/unplugging power cables.
All this retail therapy got me reminiscing back to my early computer days. This may be lost on you if you are either under 25 or live outside the UK. If so you may wish to educate yourselves by seeing what your IT ancestors had to put up with by clicking the links provided.
My first job was in a major high street bank that had the “cutting edge” IBM System 360 (with up to 256Kb of main storage) and System 370 mainframes complete with dual-processor capability, support for virtual memory and 128-bit floating point arithmetic. Such beasts were required to deal with the masses of data dealt with on a daily basis.
Not long after that a very entrepreneurial Englishman by the name of Clive Sinclair released the Sinclair Spectrum. Clive, later to be called Sir Clive Sinclair, was one of those guys with great ideas but virtually no sense of reality. Some of his inventions (like the C5 electric car launched in 1985!) just beggared belief. He had virtually no marketing knowledge and more or less just expected the products to sell themselves.
The Spectrum was an 8 bit personal computer that replaced the earlier ZX80 and ZX81 models. It has a massive 16Kb of RAM and an external floppy drive. Whoopie! In the coming months and years, developers rushed to write their applications and games for it meaning that for the first time you had a portable home computer.
We’ve come a long way since the early 1980s. Thankfully not all of the inventions we saw have been successful. Here I am arguing the merits of whether I want a standard power cable for a disk drive that has a capacity that is many hundreds of thousands bigger than the IBM 360 series. Oh and it fits in a shirt pocket rather than a 60 square yard room complete with cooling system!




