
Technical Writer on Medium and Design Consultant of @ClickHelpNews. I tweet about #techwriting #webdesign #technicalcontent
Los Angeles, CA
Joined May 2016
- Tweets1.8K
- Following246
- Followers2.3K
- Likes1K
Brad Nice π¨βπ» retweeted
Our November 2026 update is out:
β Move to the new Reader UI and keep your look
β Find every link to a topic or file in seconds
β Manage access groups through the API
β Docs that AI agents can read
Release Notes: tinyurl.com/4espna9y
#TechnicalWriting #Documentation
Brad Nice π¨βπ» retweeted
Ask ChatGPT about your product. Then ask where it got the answer.
If AI canβt find or read your docs, the answer likely comes from somewhere else.
Are Your Docs Invisible to AI? Nov 5, 17:00 CET / 11 AM EST
Canβt make it? Get the recording: tinyurl.com/y3kkf8k7
Brad Nice π¨βπ» retweeted
βWe need AI in our docsβ means three different things to three people in the room: autocomplete, a chatbot, or an agent that publishes on its own.
We mapped it into 5 levels of autonomy, from editor to autopilot. Almost no one is at L4 yet.
π tinyurl.com/54cf7ebu
#AIdocs
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





















