
Technical Writer on Medium and Design Consultant of @ClickHelpNews. I tweet about #techwriting #webdesign #technicalcontent
Los Angeles, CA
Joined May 2016
- Tweets1.8K
- Following248
- Followers2.3K
- Likes1K
How often does an AI assistant give a correct answer to the wrong person?
A Standard-plan user asks your AI assistant about SSO. It answers from the Enterprise docs. The text matched, the plan didnβt.
Embeddings capture what the text means, not who itβs for.
Metadata fills that gap β tinyurl.com/5hdtxaed
#TechnicalWriting #RAG #TechComm #AIdocs
Brad Nice π¨βπ» retweeted
Your support address changes. It lives in 4 manuals and 2 languages. One copy gets missed, and a user calls the wrong number.
How to publish several manuals from one sourceβ tinyurl.com/drxsdjj2
#TechnicalWriting #SingleSourcing #TechComm #Documentation
Brad Nice π¨βπ» retweeted
Who Are You Actually Writing For?
Explaining "what is a subnet" to a CCIE engineer loses them in one line. Skipping VPC basics loses a junior. This article covers how to profile readers you'll never meet.
Read β tinyurl.com/mkrumkty
#TechnicalWriting #TechComm #Documentation
Brad Nice π¨βπ» retweeted
Your changelog and your release notes should never read the same. One's for developers. One's for users. Most teams write both the same way β which is why nobody reads either.
Read more β tinyurl.com/4y8mec2y
#TechnicalWriting #ReleaseNotes #DevOps #TechComm #CICD
Brad Nice π¨βπ» retweeted
Ask MT to translate the same term twice, and there's no guarantee it comes back the same way. That's how one feature name ends up with three names across your docs.
We asked @alconost what actually fixes it.
Read hereβ tinyurl.com/yxamm92s
#Localization #TechDocs #AI
Brad Nice π¨βπ» retweeted
Docs-as-code brings technical documentation into the same workflow as software development: Git, pull requests, versioning, CI, automated validation, and continuous publishing.
In this article: popular docs-as-code tools β tinyurl.com/2uuzse7j
#TechnicalWriting #DocsAsCode
Brad Nice π¨βπ» retweeted
Two sentences that explain this better than any doc redesign meeting:
Text tells users what to do. Video shows how it actually looks in the UI.
Full breakdown of when to use each format β tinyurl.com/wmyn2m9x
#TechnicalWriting #TechComm #Documentationtips
Brad Nice π¨βπ» retweeted
AI agents are only as useful as the data they can reach.
MCP changes that β one server, any compatible client.
We built a working MCP server in Python in under 30 lines.
Step-by-step guide π tinyurl.com/yc87rbxn
#mcpserver #python #TechComm
Brad Nice π¨βπ» retweeted
DITA promises structure. CCMS promises scale. But most tech writing teams just need their docs to stop being a mess β and neither requires XML.
When does structured authoring actually pay off (and when it doesn't)?
Read tinyurl.com/3xacfphz
#TechnicalWriting #TechComm #dita
Brad Nice π¨βπ» retweeted
Publishing docs for more than one product or brand? ClickHelp now lets you run several independent, public-facing documentation sites from a single portal.
One place for authors. Separate sites for readers.
Now in public beta β try it free at clickhelp.com
Brad Nice π¨βπ» retweeted
Regex = superpower for technical writers.
Search, replace, extract, automate β in seconds instead of hours.
Full guideπ tinyurl.com/35fbyb9z
#TechnicalWriting #TechComm #Documentation #regularexpressions #regex
Brad Nice π¨βπ» retweeted
Google Docs works well for small docs.
But at scale β reuse, versioning, and publishing become painful.
Read π€ tinyurl.com/ybnp2mrc
#TechnicalWriting #TechComm #Documentation #AI #ClickHelp #GoogleDocs #KnowledgeManagement #SingleSourcing
Brad Nice π¨βπ» retweeted
AI agents are no longer just βreadingβ documentationβthey can now interact with your documentation portal directly via MCP (Model Context Protocol). This opens the door to more dynamic technical writing systems.
π tinyurl.com/ypmdc5v3
#AI #MCP #TechnicalWriting #Documentation
Brad Nice π¨βπ» retweeted
AI is changing customer support β not by replacing humans, but by helping them work faster. With Agent Assist tools.
The result: faster resolutions, happier customers, less burnout.
Read more π tinyurl.com/fywmbnwv
#CustomerSupport #AI #AIAgents #CX #CustomerExperience
Brad Nice π¨βπ» retweeted
Still sending users to a separate help page mid-task? That's where they drop off.
In-app help keeps guidance inside the product right where users need it.
Read more π tinyurl.com/3sfkwdrm
#InAppHelp #UserOnboarding #ProductAdoption #UX #TechnicalWriting
Brad Nice π¨βπ» retweeted
Your documentation exists, but AI tools can't read it.
When ChatGPT fetches your portal and gets a wall of HTML, it guesses. Sometimes it guesses wrong (confidently.)
The content is fine, the delivery isn't.
Read tinyurl.com/3ykd9j7p
#TechnicalWriting #AITools #Documentation
Brad Nice π¨βπ» retweeted
Architecture docs help teams align on system structure, decisions, dependencies, and future changes.
A practical guide to writing architecture documentation thatβs actually useful πtinyurl.com/3vkvhbyu
#TechnicalWriting #SoftwareArchitecture #DevDocs #Documentation
Brad Nice π¨βπ» retweeted
Developer docs arenβt just βnice-to-have.β
Theyβre core infrastructure for IT teams β just like CI/CD, observability, and security.
Learn how to build docs that reduce outages, speed up onboarding, and actually stay up-to-date πtinyurl.com/4323me8p
#DevDocs #DevOps #techcomm
Brad Nice π¨βπ» retweeted
Our April 2026 update is out π
Claude and Cursor can now read and write your ClickHelp docs directly.
Plus API v2, Markdown export, language switcher, and more.
Read the details β tinyurl.com/5fcbxw3z
#update #clickhelp #ai #mcp #techcomm #technicalwriting
Brad Nice π¨βπ» retweeted
Creating software tutorials? Make them clear, structured, and actually useful π
βοΈ Step-by-step approach
βοΈ Visuals & interactivity
βοΈ Beginner-friendly logic
Learn how to build tutorials users love: tinyurl.com/yc4ubmpd
#techcomm #TechWriting #SaaS #Documentation #UX





















