Knowledge base architecture · Structured authoring · Support deflection
FocusVision — Turning a Neglected Knowledge Base Into a Self-Service Resource
FocusVision supported three distinct software product lines: a web survey platform, a panel management platform, and a qualitative focus group diary platform. A knowledge base existed to serve all three, but it wasn't doing the job. The entire documentation set — roughly 1,000 articles — was maintained by a single technical writer with part-time assistance from an SQA specialist.
The problems compounded each other. Coverage was thin relative to three separate products. Existing content had no consistent structure or voice, because there was no style guide and no article templates to enforce one. Nothing existed to keep published articles current as the products changed. The practical result was that neither clients nor internal staff trusted the knowledge base enough to use it, which meant support absorbed volume that documentation should have deflected.
- Redesigned the knowledge base and the documentation processes behind it, addressing both the structure of the content and the workflows that produced it.
- Created a style guide and a set of article templates to establish consistent structure, voice, and quality standards across all three product lines.
- Sourced additional writing support from the support organization, recruiting support agents into the documentation effort to expand capacity without waiting on headcount.
- Established a content refresh program that brought engineers, product managers, support agents, and technical writers together for a weekly review of existing articles.
The documentation set grew from 1,000 to 2,500 articles over two years, with the quality of existing content improving alongside the expansion. The knowledge base became a resource clients and staff genuinely relied on to self-serve, and the cross-functional refresh program gave the content a maintenance model that didn't depend on any one person.