Category Archives: findability

Recording of STC Berkeley presentation on why users can’t find answers in help

Berkeley recording podcast

A few weeks ago I gave a presentation to the STC Berkeley chapter on findability of help content. The recording is available here: Your browser does not support the audio element. Download MP3 (right-click, then Save Link As) For the slides, see Recording and slides for why users can’t find answers in help. The link Continue Reading »

DITA’s output does not require separation of tasks from concepts

concept and task thumb dita

One of the main challenges to embracing DITA is accepting the idea that tasks and concepts should be separated. However, despite the common assumption that concepts and tasks should live separately when you follow DITA, actually it’s not the case. You can combine concepts and tasks in DITA’s output through your ditamap. Additionally, you can Continue Reading »

Single sourcing and duplicate content (search engine optimization)


One of the challenges technical writers face in search engine optimizing their documentation is deliberating between single sourcing and duplicate content. Google tries to return a variety of unique results, rather the same versions. If you have multiple versions of the same content online, Google will likely just rank the version it perceives as best Continue Reading »