The Owlery

— a blog for knowledge base knacks and hacks

8 of our favorite documentation sites in the software industry

10/17/2017Catherine Heath
There are some really great documentation sites in the software industry, both aimed at the end user and developers. Everyone can benefit from top-notch documentation.

Creating the information architecture for your documentation

10/09/2017Catherine Heath
Information architecture is distinct from the quality of your documentation writing. There are categories, there is order, and the structure (hopefully) makes sense.

How to get started writing your end user docs

10/03/2017Catherine Heath
If you offer any kind of product for your customer, but especially software, you'll need to produce some kickass user docs to go with it.

The docs-like-code approach to documentation production

09/27/2017Catherine Heath
The docs-like-code approach attempts to bridge the gap between what is often seen as two distinct fields: engineering and writing.

Write the Docs Prague conference 2017

09/19/2017Catherine Heath
We attended Write the Docs 2017, an inclusive community for technical writers - and anyone else interested in the wonderful world of documentation.

Use active voice in your documentation for happier readers

08/30/2017Catherine Heath
We know that writing technical content is important, and the way you write that content is even more important. It has to be accessible and easy to understand, so you need to use active voice.

The rise of the knowledge economy

08/23/2017Catherine Heath
Knowledge is now the most valuable asset of a business. The knowledge economy is often considered a buzzword but it should be better understood by businesses who want to get ahead of the curve.

Every page is page one for documentation

08/08/2017Catherine Heath
Every page is page one for documentation Catherine Heath | August 8, 2017 Content consumption habits have been drastically changed by the internet. It’s completely revolutionising how we structure user documentation, and content in ...

Avoid sleazy online marketing tactics and respect your customers

07/14/2017Catherine Heath
Avoid sleazy online marketing tactics and respect your customers Catherine Heath | July 13, 2017 You know the kind of marketing we mean. It leaves a bad taste in your mouth like a used car salesman, and suggests that the company responsibl...

How software companies can use their knowledge base for abstract content marketing

07/06/2017Catherine Heath
How software companies can use their knowledge base for abstract content marketing Catherine Heath | July 6, 2017 Your company knowledge base is a fantastic way to market your company in this late age of advertising and marketing. It&rsquo...
Subscribe and get notified as new articles arrive
(No spam, pinky promise)