Technical Writer on Medium and Design Consultant of @ClickHelpNews. I tweet about #techwriting #webdesign #technicalcontent

Los Angeles, CA
Joined May 2016
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
41
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
5
7
26
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
5
7
56
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
7
8
54
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
6
7
69
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
7
9
47
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
5
5
43
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
1
6
7
109
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
6
7
62
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
7
8
77
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
6
6
45
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
7
7
40
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
2
7
8
111
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
7
7
41
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
6
6
52
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
1
7
8
73
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
7
8
53
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
7
7
58
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
1
7
9
180
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
7
8
108