A few times I’ve mentioned about how I manage collections of PDF documents, Text files and the accreted detritus of a Network Engineer. Since a number of people have asked me to talk in more detail about how I organise this and what methods I use, here is some rough description of how I perform knowledge management.

PDF or Web Pages

In terms of reading documentation to find what I am looking for then, without doubt, a Web page is the easiest way to review lots of materials to find what you are looking for. Most of the web pages on a vendor site aren’t the core technical information that I’m looking for.

Once I’ve found a useful document, white paper, technical reference, product manual or whatever then I will download it to keep for reference.

Why download it ?

Big companies have big websites. And big websites have things changing and moving, and a bookmark isn’t useful two or three years later because the content has moved. It’s frustrating to recall that read about something but cannot find it. If it’s a blog page, then blogs often disappear when people change lives and decide to stop paying for the hosting. Or maybe the content changes over time. I’ve learned that you can’t rely on the Internet to be a reliable content store.

Downloading it isn’t enough.

So, now that you have downloaded a bunch of PDF files you have to find a way to organise them into meaningful data.

Consider a PDF file from Brocade on VCS Fabric Technical architecture. I might want to classify this into the following:

Brocade
VCS
TRILL
Ethernet Fabric
Data Centre
Design
Architecture

In the same way a Cisco MediaNet 4.0 QoS Design Guide might be any of the following:

Design
Cisco
QoS
shaping
design
Design Guide
Policing
video
voip

and so on. To solve this problem, you need more than a directory on hard disks, you need a tool that can organise files according to some other schema. I found myself wasting many hours searching for PDFs that I remember reading but cannot find.

Many Tools

My toolset for handling this is entirely based around Mac OSX specific features and software that I’ve bought. In general, I could have scripted any of these tasks but the time taken to write and debug these scripts is more than the cost of the apps that do these tasks. And many of these apps have way more features than a script, and these features are also valuable. As a rule, I choose to pay for my software since I believe that these products will survive over the longer term.Therefore I will walk through the process as I adopted tools, then moved onto more complex tools as I tried new ways of working.

As far as I know, there are no programs that perform equivalent functions on Windows or Linux. Frankly, nor do I care. Go somewhere else if you want those solutions.

HoudahSpot

The first tool I used was HoudahSpot. Regular Mac Users will be familiar with the Spotlight which creates a detailed search index of all files on the disk. HoudahSpot is a front end that helps to search for files.

HoudahSpot with a sample search.(Click for a full size image)

As you can see, you can search in the text or the name, or in your email. There is almost nothing that cannot be search in an easy to use interface. It supports search templates which allows me to define regular search types instead of typing up repetitive searches.

So HoudahSpot worked well for while and I still use it today for searching because it’s easier and faster than Spotlight – even with regex searches. However, I needed to gather files together in better ways – while I could find things, I couldn’t organise things.

Although today I’d consider the Mac App Store version which is called Tembo – but I already own HoudahSpot. It’s a great application and I highly recommend it.

A small thing. Apple Spotlight does not easily search non-standard locations outside of the Documents folder. HoudahSpot allows you to search anywhere on your disk drives by creating your default search template – useful for apps that allow you to have unnamed files in the iCloud folders.

HoudahSpot integrates with QuickLook

One of the greatest utilities in OSX is QuickLook. Whenever you have a file selected in Finder (or just about any other app) you can press the spacebar to get a preview of the file. Works for almost any file type, even Word files.

Using Quick Look to Preview Files in HoudahSpot.(Click for a full size image)

Directory Storage and Leap

Searching is fine, but I really need to peek or preview files to see what they are. Although Preview in HoudahSpot does work, sometimes I need something faster. So the next program I used a lot is Leap from Ironic Software.

Caption Text.(Click for a full size image)

As you can see, it’s supports OpenMeta tags (more on this in Part 2) for search, and can edit them. You can hit the Spacebar to QuickLook any file (OSX feature) and you can change the view to get a display of the first page – often useful.

Caption Text.(Click for a full size image)

When I went through my Leap phase, I stored files in directories by vendor and then tagged files by technology. The nice thing about Leap is that you find things that you had forgotten about. Serendipity is a great tool for having a wide recall of knowledge. Therefore, I use Leap to cruise around my PDF library which hasn’t been tagged (see below) and sorted in DevonThink (also, more below).

I’ve also looked at the sister product from Ironic called Yep. I couldn’t quite understand how to make that work, but I think it could do some limited knowledge management.

In Part Two, I’ll look more at Tagging and Collecting Text and PDF files.

My Knowledge Management Process with PDF Files – Part 1