Cool tools for Technical Authors – video equipment

We’re sharing some of the tools we use at Cherryleaf. This time we’ll look at video recording.

screencast screenVideo is becoming an important medium in technical communication. In addition to screencast videos (walkthroughs of application screens), software like Camtasia and Captivate enable you to include video of people in your presentations. Doing this creates a more TV-like presentation and a more professional feel to your output.

Continue reading

Cool tools for Technical Authors – audio recording

We’re sharing some of the tools we use at Cherryleaf, and this time we’ll look at audio recording tools.

It can be very useful for a Technical Author to be able to record what someone is saying. If you are gathering information from a Subject Matter Expert, you can let them just speak naturally and quickly. This can reduce the demands on their time, and it often leads to a more relaxed conversation. There can be other instances where it’s not practical to use a notepad or computer to write or type notes.

Continue reading

Cool tools for Technical Authors – note taking

I thought I’d share some of the tools we use at Cherryleaf, starting with note taking. I’ve not covered audio recording tools, as we’ll probably look at those in another post.

Moleskine

Moleskine notebooksMoleskine notebooks are a great way of taking written notes. The 13cm x 21cm size provides a decent page size, whilst being small enough to fit into an external jacket pocket. The large rule notebook contains 240 pages, which means you’re likely to need only two or three per year.

The elastic closure stops the notebook from falling open, and the bookmark helps you find the next empty page. These can be handy also if you sometimes wake up with an idea in the middle of the night. They enable you to open and find a blank page in the dark, without having to turn on the light. Once the thought is recorded, your brain can settle down to returning to sleep.

Uniball eye pens

Uniball pensThe Uniball eye is a popular, everyday pen you can pick up from pretty much anywhere that sells pens. They are reasonably priced, so it doesn’t matter if you lose one, and they seem to last for ages. You can write with minimal pressure, as the ink flows smoothly. The pens are also comfortable in the hand.

CamScanner Pro

One tool we all use is a mobile phone app called CamScanner Pro. CamScanner enables you to scan a document using your smartphone’s or tablet’s camera. It means everyone has their own personal scanner wherever they go. The app converts the image into a PDF, and then enables you to upload the document to a cloud storage service (such as Dropbox) or email it to someone. The Pro, paid, version can also convert scanned images to editable documents.

Which tools do you use to take notes?

Let us know, using the comments box below.

Your policy and procedures manual as software

Jared Spool tweeted this morning:

HyperCard was a hypertext program that came with Apple Macintosh in the 1980s. It allowed you to create “stacks” of online cards, which organsiations used to create some of the first online guides. It also contained a scripting language called HyperTalk that a non-programmer could easily learn. This meant HyperCard could do more than just display content: it could be used to create books, games (such as Myst), develop oil-spill models, and even dial the telephone.

Continue reading

The lost Steve Jobs interview – on successful products

Last night, we watched Steve Jobs: The Lost Interview on Netflix. It’s a lengthly (70 minute) interview from 1995, in which Steve Jobs discussed his recipe for a successful business. The interview was made 19 years ago when Steve Jobs was still running NeXT Computers, and just six months before he rejoined Apple.

Here are some highlights.
Continue reading

Getting information from Subject Matter Experts

Flickr photo an interview by illustirInterviews with Subject Matter Experts (SMEs) are some of the most useful sources for Technical Authors when they are gathering information about a product or procedure. This often involves asking a developer or departmental manager a series of questions focused on the types of questions end users are likely to ask.

Interviewing is one of those dark arts that Technical Authors pick up over time – techniques for getting SMEs to find the time to speak to you and review your drafts, ways to avoid conversations meandering away from what the user will want to know, tools for capturing the interview, and so on.

So what tools should you use?

Coming armed with biscuits (cookies in the USA) is probably the most effective tool! After that, the most useful tool to have is a voice recording device. If you have a smartphone, in effect, you have a digital voice recorder. There are many voice recording apps for both iOS and Android, but the one we like is Recordium.

Recordium

In addition to recording audio, Recordium also enables you annotate the voice recording. You can highlight and tag certain parts of audio recordings (for example: to indicate a new topic or to mark sections that relate to definitions of terms etc), and add attachments to those sections as well. You can use it, in effect, as an audio-orientated note clipping application, similar to Evernote.

Recordium also enables you to vary the playback speed. We’ve found this useful when SMEs are using specialist terminology – you can slow down the recording to check what it was they actually said. Listening at a faster speed is also a useful way of reviewing a recording quickly.

Technical Authors still need to transcribe sections of the interview, so it becomes text. Unfortunately, Text-to-Speech applications still have some way to go. Dragon Dictation is available for Apple devices, and ListNote offers similar functionality for Android. However, even if you are just a two fingered typist, you’re probably better off transcribing the audio yourself.

Are there any other apps you’d recommend? Let us know.

Are your user manuals (and any other content) ready for Google Glass?

Google_Glass_detail from WikipediaGoogle Glass, a wearable computer with a screen above the right eye, goes on sale in 2014. Glass is almost certainly going to be used to support maintenance and repair calls, providing technicians (and other types of user) with the ability to access manuals and discuss situations with remote colleagues.

So are your user manuals, and the other content users might need to access, compatible with Google Glass?

Continue reading

Will the next version of Microsoft Word make EPUB publishing a lot easier (or a lot worse)?

NookThere are reports on various technology websites that Microsoft is rumoured to purchasing the owners of the Nook e-book readers and tablets. There are also rumours that the next release of Microsoft Office (codename “Gemini”) will have a “publish to Nook” option.

These potential actions would help Microsoft compete with Amazon and Apple in the digital publishing market; Microsoft would be able to offer writers a feature-rich authoring tool, a publishing platform and a publishing environment, all from the same vendor. The promise is, you could write your book in Word, and be able to start selling it, in just a few clicks.

What is unclear at this moment is whether “publish to Nook” means “publish EPUB documents that will display their content nicely on other ebook readers”. Will the underlying code in the EPUB files be “clean” and not “bloated”? Let’s hope that’s the case.

Let us know what you think.