The Owlery

— a blog for knowledge base knacks and hacks

Knowledge base teamwork: 7 steps to producing documentation at scale

12/06/2017Catherine Heath
You hope your documentation would vastly improve with more firepower. Your challenge becomes how to keep quality consistent while producing content at scale.

How to know when your company needs a knowledge base

11/22/2017Catherine Heath
With useful questions to ask about your company before you invest any significant time and resources into a new knowledge base.

4 big companies using product documentation for marketing

11/15/2017Catherine Heath
Far from a boring technical necessity, documentation is a chance to promote your brand in front of existing and potential customers.

The brilliance of Adobe’s embedded contextual help

11/01/2017Catherine Heath
Contextual help is documentation presented in the software interface for a seamless learning experience.

The pros and cons of crowdsourcing your docs

10/26/2017Catherine Heath
Crowdsourcing your docs means harnessing the power of the many to produce useful help content for your users.

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.
Subscribe and get notified as new articles arrive
(No spam, pinky promise)