6 Aug 2026, 14:35 UTC44 views1 reactionsread 7 August 2026 Photo
New in ClickHelp this August 👇
Readers can now plug their own AI agent (Claude, Cursor, ChatGPT, Gemini) straight into your published docs — the Published Docs MCP Server reads your current content and answers only from what's actually there, not a guess or an outdated training snapshot.
Search also got smarter: AI Overview answers questions right in the results, and you can keep asking follow-ups without leaving s…
👍1
5 Aug 2026, 11:15 UTC57 views2 reactionsread 7 August 2026 Photo
Another one on content reuse — this time about snippet management.
Short version: if the same warning or install step is copy-pasted across 20 topics, and every product change means editing all 20 by hand — that's the sign it should be a snippet instead.
We go through the difference between variables (values: version number, email, company name) and snippets (blocks: procedures, warnings, legal text), what's actual…
❤2
29 Jul 2026, 10:17 UTC111 views1 reactionsread 7 August 2026 Photo
Technical documentation has a text problem — not too little text, but text doing jobs it's not good at.
Describing a multi-tab configuration wizard in prose takes 200 words and still leaves users guessing what the screen looks like. A 90-second screencast answers the same question and gets out of the way.
The article breaks down when each format earns its place:
- Screencasts work when the workflow is short, stabl…
🔥1
22 Jul 2026, 12:24 UTC156 views2 reactionsread 7 August 2026 Photo
Claude writes well. But without access to your actual data, it's writing in a vacuum.
MCP fixes that. One server, and any compatible client (Claude, Cursor, Windsurf) can reach your tools and data without a custom connector for each one.
We wrote a step-by-step guide to building a local MCP server in Python:
— project setup with uv
— a working tool with @mcp.tool() in 30 lines
— local testing with MCP Inspector bef…
🔥2
21 Jul 2026, 12:30 UTC139 views1 reactionsread 7 August 2026 Photo
Docs aren't just read by people anymore. So we tested how AI handles them.
We ran a quick test: gave ChatGPT a link to one of our documentation pages and asked it to summarize what it was about.
It opened the link, read the page, and answered in seconds. No extra steps.
Small result, but a good reminder — docs today get opened by more than just people.
Search engines, AI assistants, link previews in Slack and Link…
👍1
15 Jul 2026, 14:11 UTC165 views2 reactionsread 7 August 2026 Photo
DITA is powerful. But does your team actually need it?
Topics, maps, reuse, single-source publishing — it all works. Just comes with an XML editor, a publishing engine, a CCMS, and months of setup.
For a 3-person team with one product: almost always overkill. For 20+ authors, five languages, and regulatory requirements: almost always worth it.
Between "Word doc chaos" and "full enterprise CCMS" there's a whole spe…
👍2
9 Jul 2026, 13:55 UTC189 views1 reactionsread 7 August 2026 Photo
Ever nodded along when someone said "send me the BRD" — and then quietly Googled what that actually means?
New article breaks down five core product documents: MRD, BRD, PRD, Tech Spec, and User Stories. What each one is, who writes it, when it appears — and how they all connect in a real SaaS product example.
Plus: three scenarios at the end (startup, agile team, enterprise) so you know exactly which docs your sit…
👍1
8 Jul 2026, 12:57 UTC170 views2 reactionsread 7 August 2026 Photo
📢 New in ClickHelp: multiple documentation sites, one portal
If you publish docs for more than one product, brand, or audience, this one's for you.
You can now run several independent, public-facing documentation sites from a single ClickHelp portal. Authors manage everything centrally — but each site appears as a fully separate website to readers, with its own custom domain, branding, home page, and set of publicat…
👍1🔥1
24 Jun 2026, 11:58 UTC235 views1 reactionsread 7 August 2026 Photo
Regular expressions are one of the most powerful tools for technical writers — yet often underused.
They can turn hours of manual editing into seconds:
- bulk replace patterns,
- clean markup,
- extract data,
- and automate repetitive documentation tasks.
If you work with large docs, APIs, or structured content, regex is a skill worth mastering.
👉 Read the full guide here
👍1
17 Jun 2026, 12:36 UTC234 views2 reactionsread 7 August 2026 Photo
📄 Google Docs works great when documentation is small. A few guides. A few contributors. A few updates.
But things change when documentation grows across products, teams, languages, and publishing channels. Content gets duplicated, updates become harder to track, and maintaining consistency turns into a challenge.
At that point, you start needing a more structured way to manage content.
In our latest article, we c…
👍2
10 Jun 2026, 13:03 UTC234 views2 reactionsread 7 August 2026 Photo
Something shifted in how technical writers think about video, and it's mostly because the editing part got a lot less painful.
AI tools like Descript, Synthesia, HeyGen, and Guidde are making it possible to go from a rough screen recording to a polished, captioned, multilingual video, without a production team or a full day of editing.
That changes what's realistic for documentation teams. Voiceovers, captions, ava…
👍2
8 Jun 2026, 13:53 UTC179 views2 reactionsread 7 August 2026 Photo
AI agents are no longer just “search tools for documentation.”
Something more interesting is happening: they’re starting to actually interact with documentation systems, not just pull answers out of them.
MCP (Model Context Protocol) is what makes this possible. It gives AI agents a structured way to connect to a documentation portal — so they can use context, access information more intelligently, and work with th…
🔥2
Showing the 12 most recent of 20 posts we hold for @clickhelp_technicalwritingblog. View and reaction counts are the latest single reading for each post, not a live figure, and a recent post is still accumulating both. A view count marked ≈ was rounded by Telegram before we ever saw it — t.me prints views in full below 1,000 and to three significant figures above, so ≈1,200,000 means somewhere between 1,150,000 and 1,249,999. Unmarked counts are exact. Text is reproduced from the public post preview and truncated for length.