One of the most popular posts on my blog was written a few years ago but still gets a lot of visits and comments; How to embed linked images in Word 2007.

Some of the comments have offered better solutions and one in particular I found myself searching for today. Having upgrade to Office 2010 I’ve realised that Microsoft has, again, “improved” the user interface by moving things around!

So, courtesy of Sarah, here are the updated instructions for how to embed linked images in Microsoft Word 2010:

1. With your Word document open, click the File tab, top-left of the window.
2. On the left-hand side, select Info.
3. On the right-hand side, near the bottom, click Edit Links to Files.
4. In the dialog that is displayed, select and highlight the images you want to convert from the list.
5. Check the Save picture in document checkbox.
6. Click the Break Link button.
7. Click OK to confirm.

The links are removed and the images are now embedded in your Word document.

A quick check of the filesize of the Word document should show a marked increase and you can now distribute the Word document, and the Word document only, safe in the knowledge that the images are embedded.

I’m in the midst of interviewing to fill a vacancy for a technical writer in our team. I’m also thinking ahead as to how to get them integrated into how we do things. And then I remembered what we have done previously.

“Hello, welcome to our wonderful company. Here is a copy of the software, and the installation guide. Go!”

OK, it’s not quite like that but it is a good opportunity to check over a part of the documentation that is crucial but can be neglected.

Product installations come in all shapes and sizes, from those simple wizard driven screens to systems which require all manner of pre-configured and pre-installed supporting applications. The latter can be the trickiest as often there is a myriad of possible, valid, scenarios, and can lead to a lot of presumption.

Regardless, the installation is the first time the real users get to get their hands on your product and so it’s a good place to get reviewed by the closest person you’ll have to a new customer. A new member of your team.

A few weeks ago I mentioned that we were looking for a new way track our tasks. After checking out a few different applications and web applications, I think we have a solution.

The problem we have is that, whilst the bulk of the work is scheduled against a project plan, there are a myriad of smaller tasks and documentation changes that we need to track. These come in through various channels, our Support team, our ‘Core’ team (who maintain the latest stream of the product), and through our team inbox.

Previously we mirrored the development teams approach and used index cards and a BIG whiteboard but it wasn’t really working for us for a variety of reasons. So I spent a couple of days downloading task tracking applications, and hunting for a web-based application that might meet our needs.

There are many out there and the first thing I realised is that most of the are aimed at the project management set and are very date driven. Most of the tasks we wanted to track aren’t heavily date driven, and so are picked up as and when the team has a some spare time in the project plan.

One of the first applications I found was TeamWorkPM which seemed to fit our needs and then some. However it was still quite over-spec’d for what we had in mind so when I stumbled over No Kahuna it was soon apparent that I’d found a good match.

Importantly, No Kahuna is a task tracking application. Dates do not feature. You simply create a project, add project members, then start creating tasks. You can assign a task to a specific project member (or take it for yourself) and when it’s done, it’s marked as completed.

You can add comments to tasks, which is useful when some tasks may sit in the list for a while so you can build out a level of information for when they are finally actioned.

All very simple, it worked well enough in our short trial that I’m happy to shell out $7 a month to get a private project (not visible to the public). If you are looking for an online, lightweight task tracker, check out No Kahuna.

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.

In my copious spare time I have been known to design and build websites. The first website I ever built was for the first company I worked for, back in 1996, so I’ve been at it a while.

However it’s only been the past couple of years that I’ve started to get some larger clients with grander ideas, and that has meant getting a bit more organised. As such I now have a standard questionnaire that I ask all prospective clients to fill in, a standard design proposal document which I use to present back my ideas based on the answers to the questionnaire, and I have a nice little area of my PC which is dedicated to building websites.

The key part of which is XAMPP.

I discovered this marvellous application about 3 years ago, and if you are building websites, or installing and customising anything that requires MySQL and PHP then you must give it a look.

Many people know from their own experience that it’s not easy to install an Apache web server and it gets harder if you want to add MySQL, PHP and Perl.

XAMPP is an easy to install Apache distribution containing MySQL, PHP and Perl. XAMPP is really very easy to install and to use – just download, extract and start.

It really is that simple. Once you’ve downloaded it, start up the Control Panel, start Apache and MySQL, then head to http://localhost. Done!

A lot of my web design work is creating custom themes based around WordPress, sometimes it is just a look and feel but more often than not custom code is required. Now, rather than having to upload a file to a test web server somewhere, I can work locally on the php files, and just refresh the browser to see my changes. Much faster.

XAMPP is one of those applications that, after you’ve used it once you think “how the hell did I manage without this!”.

Given that a lot of technical communicators are looking towards other distribution models (blogs, Wikis and so on), then XAMPP is an easy (and free) way to get a test system setup, allowing you to run short proof of concept projects. I hope you find it as useful as I do.

Technical documentation, typically, requires screenshots and I, like many, have been through the gamut of software applications that can be used. Currently I’m quite happy with Gadwin Printscreen, but recently stumbled across something a bit different.

Whilst I don’t use it at work, I have a MacBook at home and I use an application called Skitch on there to do random screengrabs and so on. It is a simple, friendly little application that is aimed at the casual user. It’s very easy to grab a screenshot, markup an area and save both image and markup to JPEG.

PrtScr is a similar kind of application for Windows, allowing a free drag and grab style screenshot capability, and the option to add simple, hand drawn markup. It’s very simplistic and whilst I seriously doubt it would find a place on the desktop of most technical communicators, it’s a nice little option if you are looking at doing something a little less formal.

Using Author-it to produce Word documents is easy. The tricky bit is distributing them.

Without running any post publishing macros, the Word document that is generated will be using linked images. So everytime you need to distribute the document you’ll also need to remember to include the images as well.

I frequently forget this, hence why I’m posting this, so, if all else fails, I can at least search my own blog to find the solution. If you look at a document with linked images, you’ll see that the filesize for the document is quite small, and there will be a number of images in the same folder (although this works fine if your images are linked from another folder).

UPDATE: You can also do this automatically after publishing using an afterPublish Word macro, the Author-it Knowledge Centre has the details, thanks to Derek Tomes for pointing it out. Read on for the manual method.

You can quickly and easily convert linked images to embedded images in Word 2007. Here’s how:

1. With your Word document open, click the Office button*, top-left of the window.
2. Select Prepare > Edit Links to Files.
3. Select and highlight the images you want to convert from the list.
4. Select the option to Save picture in document.
5. Click the Break Link button.
6. Click Yes to confirm.

The links are removed, and the images are now embedded in your Word document. A quick check of the filesize of the Word document should show a marked increase and you can now distribute the Word document, and the Word document only, safe in the knowledge that the images are embedded.