Blog
From the team
Product updates, structured authoring insights, and documentation best practices.
thought-leadership
Where AI helps technical writers - the evidence
Writers already draft with AI. The evidence puts the real gains elsewhere: detecting changes, testing docs against the product, and finding gaps. Sources inside.
sop
How to write an SOP - a writer's guide
Interview the operator, pick a granularity, draft in imperative voice, and pressure-test exceptions. A working writer's method for SOPs, not a template tour.
SOP
SOP examples - real templates by industry (2026)
Five industry-specific SOP examples — manufacturing, IT, food service, warehouse, healthcare — with the structural choices and regulations behind each one.
SOP
SOP software - 3 tiers, not 15 tools (2026)
The 'best SOP software' lists conflate 3 different categories. Tier 1 checklist apps, Tier 2 document management, Tier 3 structured authoring (CCMS).
SOP
SOP template - free format guide for 2026
What sections a real SOP includes, why numbered steps beat bullets, and how to handle role-based variations without maintaining 6 copies of the document.
SOP
What is a SOP - a writer's guide
What separates a standard operating procedure from a work instruction or policy, why SOPs deteriorate within 18 months, and what FDA and ISO 9001 require.
CCMS
Why I left enterprise CCMS to build Topicary
A founder's honest account of what enterprise CCMS gets right, where it breaks for small teams, and the deliberate tradeoffs behind Topicary.
release notes
Release notes template - examples and format
What belongs in a release note, why developers and customers need different versions, and a section-by-section template plus three real-world examples to copy.
SRS
SRS vs PRD vs BRD - which one to write (2026)
A decision framework with a comparison matrix and four scenarios to pick the right requirements document for your initiative.
single source publishing
Single source publishing - a practical guide
Single source publishing means writing once and rendering to web, PDF, and Markdown. The four technical requirements, where tools fail, and what to test.
technical writing
Technical documentation examples - 7 templates
Seven technical documentation examples from Stripe, Twilio, and Linear with reusable templates, comparison tables, and patterns any docs team can copy.
CCMS
Your 5-person docs team does not need a $50K CCMS
Enterprise CCMS platforms cost $50K to $200K a year and need a dedicated admin. When 2 to 15-writer teams should pick lightweight instead, and the limits.
thought-leadership
SME review problem - causes and fixes 2026
Three reasons subject matter experts skip documentation review: wrong tool, wrong process, wrong incentives. The workflow changes that get reviews done.
PRD
Product requirements document template (2026)
A free PRD template with eight sections, non-goals guidance, and the boundary between a PRD, SRS, and design spec.
SRS
Software requirements specification done right
How to write an SRS against ISO/IEC/IEEE 29148:2018, with EARS notation examples and a practical outline to replace IEEE 830.
version-control
Documentation version control - a practical guide
Change history, rollback, and structured review belong in every doc workflow. Writers should not need to learn Git for any of it. Here is what works instead.
AI
What LLM-ready content actually means
LLM-ready content is three concrete deliverables plus one old discipline: markdown mirrors, llms.txt, an MCP server, and self-contained, retrievable topics.
comparison
MadCap Flare vs RoboHelp (2026)
MadCap Flare vs RoboHelp in 2026: a neutral head-to-head on verified pricing, the 6.6x license gap, release status, reuse depth, and Mac support.
pricing
ClickHelp pricing decoded (2026)
ClickHelp pricing runs $194 to $640/mo, but SSO, API, AI, and translation are paid add-ons. The full add-on table and a realistic 5-person config at $1,094/mo.
pricing
MadCap Flare pricing in 2026 - the full cost
Flare Desktop is $3,150/author/yr in 2026, Flare Online is quote-gated, perpetual is gone. The full MadCap Flare cost breakdown, with verified receipts.
review
MadCap Flare review (2026)
An honest MadCap Flare review: 4.4/5 on G2, deep single-sourcing, a steep learning curve, and a $3,150/author subscription. Verdict by team situation.
comparison
RoboHelp alternatives (2026)
RoboHelp is alive but incremental, and the price just rose. An honest roundup of RoboHelp alternatives - Flare, ClickHelp, Paligo, Topicary - with 2026 pricing.
comparison
Help authoring tools worth using in 2026
A roundup of 7 help authoring tools for 2026: Flare, RoboHelp, ClickHelp, Document360, Paligo, GitBook, Topicary. Which fits which team, with real pricing.
comparison
Topicary vs Adobe FrameMaker - compared for 2026
Adobe FrameMaker is a desktop long-document engine. Topicary is a cloud CCMS with reuse and hosted publishing. Where each fits, and the migration path.
comparison
Topicary vs Adobe RoboHelp - compared for 2026
Adobe RoboHelp is a desktop help authoring tool in deep maintenance mode. Topicary is a cloud CCMS with AI and hosted publishing. Where each fits in 2026.
structured authoring
Structured vs unstructured authoring (2026)
Structured authoring reuses semantic blocks; unstructured writes free-form docs. When each fits a small team, the real migration cost, and a decision framework.
structured authoring
What is structured authoring - a plain guide
Structured authoring means writing content as reusable blocks, not whole documents. Before-and-after examples, the four building blocks, and when it pays off.
comparison
Archbee alternative - real cost and reuse (2026)
Archbee's $80/mo plan excludes reuse, variables, and versioning; the tier that has them is $350/mo. Topicary has reuse from $79 and all three at $149/mo.
CCMS
AI kills the CCMS interface, not the contracts
Fifteen years inside a DITA CCMS taught me the interface is what AI deletes and the contracts are what survive. What that means for documentation.
comparison
Paligo vs MadCap Flare (2026)
Paligo vs MadCap Flare compared honestly: authoring model, reuse, collaboration, output depth, and verified 2026 pricing - plus when neither is the answer.
comparison
ClickHelp alternative - Topicary compared (2026)
Need a ClickHelp alternative? Topicary compared on reuse model, add-on math, Git sync, and DITA export, plus the cases where ClickHelp is the better pick.
comparison
MadCap Flare alternatives (2026)
Leaving MadCap Flare? An honest roundup of the real alternatives - Paligo, Heretto, ClickHelp, Document360, docs-as-code, Topicary - with verified pricing.
DITA
DITA alternative - structured authoring (2026)
DITA provides structured authoring but demands XML expertise, specialized tools, and integration work. Here is what to use instead and what you give up.
guide
Get SMEs past 'looks good' on doc reviews
Subject matter experts keep replying 'looks good' instead of catching what's wrong? Here's how to structure SME review requests for real accuracy feedback (plus a reusable template) and how to remove the friction that makes them skim.
guide
Living documentation and how to build it
Living documentation is not docs auto-generated from tests. For most teams it means content that surfaces its own decay and responds to readers. The four feedback loops that keep docs alive, and how to build them.
content reuse
Content reuse - from copy-paste to single source
Content reuse software replaces copy-paste with one source, multiple outputs. The 5 levels of reuse maturity, where each breaks down, and how to escape.
guide
How to audit your documentation
A documentation audit finds the stale, broken, orphaned, and duplicated content before your readers do. Here's the checklist, how to prioritize fixes, and which parts to automate so the audit never goes stale.
guide
How to version product documentation
Stop forking your docs every release. Here's how to handle multiple product versions from one source, not a copy per version. Use a reader-facing version selector, conditional content, and frozen release snapshots.
BRD
Business requirements document template (2026)
A free BRD template with nine sections, guidance on what belongs in each, and the line between a BRD, PRD, and SRS.
migration
How to migrate from Confluence to Topicary (2026)
Leaving Confluence or K15t over per-seat cost? Step-by-step: export your space as HTML, import to Topicary, rebuild structure, what macros survive, and when staying on Confluence is the honest call.
comparison
Topicary vs Confluence for product docs (2026)
Leaving Confluence and K15t/Scroll over per-seat cost? Topicary is a true CCMS for product docs: component reuse, conditions, and flat $0/79/149 pricing.
api documentation
API documentation tools - beyond Swagger in 2026
Swagger UI generates API reference from your OpenAPI spec but skips tutorials, auth, and changelogs. Five doc types, four tooling approaches, how to pick.
migration
How to migrate from GitBook to Topicary (2026)
Leaving GitBook after the price change? Step-by-step: export your content as Markdown, import to Topicary, rebuild structure, plus honest cheaper options.
comparison
GitBook alternatives for API docs (2026)
Leaving GitBook? An honest roundup of API and dev-docs alternatives (Mintlify, ReadMe, Stoplight, fumadocs, MkDocs, Topicary) with verified pricing.
AI
Why AI needs structured content (2026)
AI-first doc tools promise self-updating help articles. But unstructured content drifts silently when AI updates one passage and misses 39 copies elsewhere.
migration
Migrate from MadCap Flare to Topicary (2026)
Step-by-step Flare migration guide. What transfers automatically (topics, snippets, TOC, variables, conditions, cross-references, images, downloads, publication targets, branding), what needs manual work, and realistic timelines.
thought-leadership
Your docs are AI infrastructure now
LLMs are probabilistic. Your docs cannot be. Structure-aware AI (components, conditions, content graphs) turns flat text into verifiable AI infrastructure.
content editor readability
Editor readability - typography beats features
Line length, font size, contrast, and whitespace directly affect comprehension and error rates. What the research says and how top content editors apply it.
comparison
18 best technical writing software tools (2026)
Technical writing software compared: Flare, Paligo, FrameMaker, Oxygen, GitBook, Confluence and 12 more. Every price checked on the vendor's own page, Oct 2026.
docs-as-code
Docs as code hit a wall - what comes next
Docs as code breaks at content reuse, conditional output, and non-engineer contributors. The practical path from Markdown and Git to structured authoring.
comparison
Topicary vs Document360 - compared for 2026
Knowledge base vs component CCMS. Content reuse depth, conditional publishing, AI features, translation, real pricing, and what Document360 does better. For teams of 2 to 15 writers.
comparison
Topicary vs Mintlify - structured docs (2026)
Mintlify's paid tier is $450/mo billed annually; Topicary adds reuse, conditions, and branded PDF from $79, variable sets at $149. Honest features and cost.
structured authoring
What is a CCMS? A plain-language guide (2026)
A component content management system manages docs as reusable blocks, not pages. What a CCMS does, how it differs from a CMS, and when your team needs one.
research
Structured authoring without XML - 59 writers
59 practitioners surveyed: 78% say XML is unnecessary for structured authoring. The data on DITA adoption, satisfaction, and what teams actually need in 2026.
comparison
Topicary vs GitBook - structured docs (2026)
Leaving GitBook after the 2026 price change? Topicary adds content reuse, conditions, variable sets, and PDF at flat pricing. Features, cost, migration.
comparison
Topicary vs MadCap Flare - compared for 2026
Side-by-side features, verified pricing ($149/mo vs $3,150/yr for each seat), migration guide, and what Flare still does better. For teams of 2 to 15 writers.
comparison
Topicary vs Paligo - cloud CCMS compared (2026)
Feature depth, real pricing, and the migration path for teams of 2 to 15 writers. Paligo still leads on PDF layout, component forking, and TMS breadth.
product
Structured authoring without XML - how it works
Component reuse, conditional content, and variables in a modern block editor — no DITA, no angle brackets. How Topicary makes structured authoring accessible.
product
Why I built Topicary - a CCMS for small teams
Enterprise CCMS tools cost $30K/yr and need weeks of training. Modern wikis skip content reuse entirely. A tech writer built something in the middle.
Ready to try Topicary?
Start free. No credit card required.