<?xml version="1.0" encoding="UTF-8" standalone="no"?><rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" version="2.0"><channel><title>TheContentWrangler.com</title><description>The online destination for content professionals. Jam-packed with case studies, articles, white papers, news and research about content heavy organizations. Find jobs, locate conferences, workshops, training, software products and more.</description><link>https://www.thecontentwrangler.com</link><image><url>https://substackcdn.com/image/fetch/$s_!7Y1e!,w_256,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ff3a0e8-b99d-4e0d-a32a-5c6739205086_110x110.png</url><title>The Content Wrangler</title><link>https://www.thecontentwrangler.com</link></image><generator>Substack</generator><lastBuildDate>Sun, 22 Nov 2026 12:58:07 GMT</lastBuildDate><atom:link href="https://www.thecontentwrangler.com/feed" rel="self" type="application/rss+xml"/><copyright><![CDATA[Scott Abel]]></copyright><language><![CDATA[en]]></language><webMaster><![CDATA[thecontentwrangler@substack.com]]></webMaster><itunes:owner><itunes:email><![CDATA[thecontentwrangler@substack.com]]></itunes:email><itunes:name><![CDATA[Scott Abel]]></itunes:name></itunes:owner><itunes:author><![CDATA[Scott Abel]]></itunes:author><googleplay:owner><![CDATA[thecontentwrangler@substack.com]]></googleplay:owner><googleplay:email><![CDATA[thecontentwrangler@substack.com]]></googleplay:email><googleplay:author><![CDATA[Scott Abel]]></googleplay:author><itunes:block><![CDATA[Yes]]></itunes:block><item><title><![CDATA[Put AI To Work In Your Technical Writing Workflow — AI Workshop for Tech Writers And Content Creators (Spring 2027)]]></title><description><![CDATA[Get real results from your content with AI-powered workflows and save 10% off the cost of registration when you use discount code &#8212; TCW &#8212; at checkout]]></description><link>https://www.thecontentwrangler.com/p/put-ai-to-work-in-your-technical</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/put-ai-to-work-in-your-technical</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 19 Nov 2026 14:31:24 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!T7J0!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp"/><content:encoded><![CDATA[<p>Many tech writers have tried AI tools. Chances are good, you have, too. But have you learned to use them in real documentation work while keeping accuracy, structure, and editorial judgment intact.</p><p>The <strong><a href="https://www.cambermast.com/c/21b86d">AI Workshop for Content Creators</a></strong> is a seven-session live course for people who want to move from experimenting with AI to building repeatable workflows. It&#8217;s led by <strong><a href="https://www.linkedin.com/in/williamraymond/">Bill Raymond</a></strong> of <strong><a href="https://www.cambermast.com/about">Cambermast</a></strong>, in partnership with <strong><a href="https://www.thecontentwrangler.com/about">The Content Wrangler</a></strong>, and is designed for technical communication and documentation specialists, content strategists, and knowledge teams.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!T7J0!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!T7J0!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 424w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 848w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 1272w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!T7J0!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:219396,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/webp&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224803020?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!T7J0!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 424w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 848w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 1272w, https://substackcdn.com/image/fetch/$s_!T7J0!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F28e7ceb2-8023-477b-9be5-571a4e7d557c_1920x1080.webp 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><strong>The course focuses on practical applications: </strong></p><ul><li><p>creating structured prompts for stronger first drafts</p></li><li><p>using review loops that support editorial standards, and</p></li><li><p>building reusable workflows for documentation teams. </p></li></ul><p>Participants work on persona-driven workflows, prompt libraries, custom GPT instructions, evaluation checklists, and a project plan they can use to put AI-assisted content production into practice.</p><p><strong>That focus on real projects matters.</strong> Tech writers don&#8217;t just need faster ways to produce text. They need workflows that help them research, draft, review, and improve content while preserving the standards their readers and organizations depend on.</p><div><hr></div><h2>What Past Participants Had To Say</h2><blockquote><p><em>Even as someone who&#8217;s been using AI tools for a couple of years, this course helped me level up fast. Bill went beyond &#8220;better prompts&#8221; and showed me advanced ways to research topics, structure real projects, and build custom GPT instructions that fit technical writing workflows.&#8221;<br><br>           </em>&#8212; <strong><a href="https://www.linkedin.com/in/melanie-r-shears/">Melanie Shears</a></strong>, Documentation Manager </p></blockquote><div><hr></div><blockquote><p><em>&#8220;I came in experienced but unsure how to use AI without losing rigor. This workshop taught a disciplined way to embed AI into real content systems. I now build persona-led workflows where AI speeds drafting while accuracy, structure, and judgment stay human.&#8221;</em><br>          &#8212; <strong><a href="https://www.linkedin.com/in/sineadcoughlan/">Sinead Coughlan</a></strong>, Senior Technical Writer</p></blockquote><div><hr></div><h2>The Curriculum</h2><p>The curriculum (see list at end of this post) moves from AI foundations and audience journeys to personalization, content audits, research, prioritization, and a final project. By the last session, participants present their work, get peer and mentor feedback, and map out next steps for AI-enabled content operations.</p><div><hr></div><h2>Workshop Dates And Cost</h2><p>The <strong><a href="https://www.cambermast.com/events/ai-workshop-for-content-creators-spring-2027?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=21b86d&amp;src=qr&amp;ad=the-content-wrangler">workshop</a></strong> runs online from <strong>January 26 through March 16, 2027</strong>. Sessions meet Tuesdays from 10 a.m. to noon Pacific, with no session on February 16. <br><br>The course includes seven live sessions and a certificate of completion. <br><br>&#128176; <strong>Tuition is $1,749</strong> &#8212; but you can <strong>save 10% when you use discount code &#8212; TCW &#8212; at checkout.</strong></p><p>If you&#8217;re ready to build AI workflows around the realities of technical writing, <strong><a href="https://www.cambermast.com/events/ai-workshop-for-content-creators-spring-2027">review the program and register for the spring 2027 workshop</a>. &#129312;</strong></p><div><hr></div><h2>Curriculum: Week-By-Week Detail</h2><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ZlvE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ZlvE!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 424w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 848w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 1272w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!ZlvE!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png" width="938" height="1426" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/fffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1426,&quot;width&quot;:938,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:254356,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224803020?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!ZlvE!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 424w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 848w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 1272w, https://substackcdn.com/image/fetch/$s_!ZlvE!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffffba3ef-375f-4fce-ace7-86a43b32e195_938x1426.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.cambermast.com/events/ai-workshop-for-content-creators-spring-2027?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=21b86d&amp;src=qr&amp;ad=the-content-wrangler&quot;,&quot;text&quot;:&quot;Register&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://www.cambermast.com/events/ai-workshop-for-content-creators-spring-2027?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=21b86d&amp;src=qr&amp;ad=the-content-wrangler"><span>Register</span></a></p><p></p>]]></content:encoded></item><item><title><![CDATA[Curious About AI, Content, And What's Coming Next?]]></title><description><![CDATA[Gain insight into AI, content, and what's changing. Just $20 a month!]]></description><link>https://www.thecontentwrangler.com/p/curious-about-ai-content-and-whats</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/curious-about-ai-content-and-whats</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 18 Nov 2026 13:31:16 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!bIFZ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png"/><content:encoded><![CDATA[<p>AI is dramatically changing how people find, understand, and use information. But what does that mean for those of us who create and manage it?</p><p>I&#8217;m <strong><a href="https://www.thecontentwrangler.com/p/scott-abel-the-content-wrangler?r=8sej&amp;utm_campaign=post&amp;utm_medium=web">Scott Abel</a></strong> and that&#8217;s what I investigate at <strong>The Content Wrangler</strong>, where I explore how information architecture, technical documentation, and editorial governance influence what humans and AI systems can understand, reason about, and do.</p><p>If you haven&#8217;t subscribed to the blog yet, I&#8217;d love to have you along. </p><blockquote><p><strong>Subscriptions are free, but for $20 a month, you can become a paid subscriber and support independent research, analysis, and commentary.</strong> If just one article a month gives you an idea you can put to work, that&#8217;s a pretty good return on twenty bucks.</p></blockquote><h2>Here&#8217;s Some Of What I&#8217;ve Been Writing About</h2><ul><li><p><strong><a href="https://www.thecontentwrangler.com/p/what-if-every-ai-model-came-with?utm_source=publication-search">What If Every AI Model Came With a Nutrition Label?</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/can-ai-learn-to-say-i-dont-know-when?utm_source=publication-search">Can AI Learn to Say &#8220;I Don&#8217;t Know&#8221; When Documentation Doesn&#8217;t Have the Answer?</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/can-s1000d-eliminate-ai-hallucinations?utm_source=publication-search">Can S1000D Eliminate AI Hallucinations?</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/does-dita-xml-reduce-ai-hallucinations?utm_source=publication-search">Does DITA XML Reduce AI Hallucinations?</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/beyond-ai-assisted-writing-how-agentic?utm_source=publication-search">Beyond AI-Assisted Writing: How Agentic AI Can Transform Content Operations</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/what-happens-to-your-help-portal?utm_source=publication-search">What Happens to Your Help Portal When Customers Get Answers From AI Instead?</a></strong></p></li><li><p><strong><a href="https://open.substack.com/pub/thecontentwrangler/p/wtfm-a-practical-guide-for-standing?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">WTFM: A Practical Guide For Standing Up Docs At A Startup</a></strong></p></li><li><p><strong><a href="https://open.substack.com/pub/thecontentwrangler/p/where-ais-tech-slang-comes-from-and?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">Where AI&#8217;s Tech Slang Comes From, And Who It Leaves Out</a></strong></p></li><li><p><strong><a href="https://www.thecontentwrangler.com/p/californias-ai-rules-are-creating?utm_source=publication-search">California&#8217;s AI Rules Are Creating New Documentation Work</a></strong></p></li><li><p><strong><a href="https://open.substack.com/pub/thecontentwrangler/p/ai-rebounding-what-employers-learn?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">[AI Rebounding] What Employers Learn When They Ask People Back After AI-Related Job Cuts</a></strong></p></li><li><p><strong><a href="https://open.substack.com/pub/thecontentwrangler/p/the-semantic-backbone-what-it-is?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">The Semantic Backbone: What It Is And What It Means For Technical Documentation</a></strong></p></li></ul><p>I&#8217;m also building a growing <strong><a href="https://www.thecontentwrangler.com/s/glossary">glossary of concepts</a> </strong>worth understanding, including <strong><a href="https://www.thecontentwrangler.com/p/what-is-interoperability">interoperability</a></strong>, <strong><a href="https://www.thecontentwrangler.com/p/what-is-maintainability">maintainability</a></strong>, <strong><a href="https://www.thecontentwrangler.com/p/what-is-traceability">traceability</a></strong>, <strong><a href="https://www.thecontentwrangler.com/p/what-is-composability">composability</a></strong>, <strong><a href="https://www.thecontentwrangler.com/p/what-is-retrievability?utm_source=publication-search">retrievability</a></strong>, and <strong><a href="https://www.thecontentwrangler.com/p/what-is-verifiability">verifiability</a></strong>. Think of it as a practical reference for navigating the increasingly complicated relationship between our content and AI.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://www.thecontentwrangler.com/subscribe?" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!bIFZ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!bIFZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1855836,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223367597?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!bIFZ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!bIFZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd27e7008-3872-4a4b-a86c-809bc6bf992a_1672x941.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h3>Want to read along?</h3><p><strong><a href="https://www.thecontentwrangler.com/subscribe?">Subscribe</a></strong> for free, or become a <strong><a href="https://www.thecontentwrangler.com/subscribe?">paid subscriber</a></strong> for just $20/month. Either way, I&#8217;d be delighted to have you reading.</p><p>Thanks for taking the time to read this message, and for your continuing support of the work I do.</p><p><strong><a href="https://www.thecontentwrangler.com/p/scott-abel-the-content-wrangler?r=8sej&amp;utm_campaign=post&amp;utm_medium=web">Scott Abel</a></strong><br>The Content Wrangler &#129312;</p>]]></content:encoded></item><item><title><![CDATA[I Couldn't Read The Safety Warnings That Came In My New Oura Ring Box]]></title><description><![CDATA[The company says it designs a &#8220;frictionless&#8221; member experience. A laughable proclamation, once you realize you&#8217;ll need a magnifying glass to read its in-box safety info]]></description><link>https://www.thecontentwrangler.com/p/i-couldnt-read-the-safety-warnings</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/i-couldnt-read-the-safety-warnings</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 17 Nov 2026 13:31:05 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!GAe0!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg"/><content:encoded><![CDATA[<p>I recently upgraded to the <strong><a href="https://ouraring.com/store/rings/oura-ring-5?srsltid=AYCX9vIIej0MDO0VO03FJM-sEJamsS4rcpI8C8P49sc-8Oz2_3hN27of">Oura Ring 5</a></strong>. It arrived in an elegant, Apple-style box with a printed <strong><a href="https://ouraringhelp.zendesk.com/hc/article_attachments/52097895480083">getting-started booklet</a></strong> inside. I am 62 years old, my vision is less than stellar, and I rely on prescription eyeglasses to read small type. I put mine on, opened the booklet, and still couldn&#8217;t make out what it said. </p><p>The type was so small that I had to devise a workaround. I photographed the pages with my iPhone and enlarged the images until the text became legible. The Oura Ring 5 getting started guide warns about skin irritation, battery charging, overheating, electrical safety, and injury if the ring catches on an object, and it states the product&#8217;s medical limitations, amongst other things.</p><p>My estimate is that the type they used is around 4 to 5 points in size. That is too small for me to read and well below the 12- or 14-point sizes that <strong><a href="https://www.cpsc.gov/s3fs-public/pdfs/guide.pdf">consumer-instruction</a></strong> and <strong><a href="https://www.england.nhs.uk/long-read/accessible-information-standard-implementation-guidance/">accessibility guidance</a></strong> recommend.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!XiH1!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!XiH1!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 424w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 848w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 1272w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!XiH1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png" width="1294" height="709" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:709,&quot;width&quot;:1294,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:294553,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:&quot;&quot;,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224514037?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F23caaa2f-c1fc-40bd-a17a-0df29bfb91e6_1294x806.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!XiH1!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 424w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 848w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 1272w, https://substackcdn.com/image/fetch/$s_!XiH1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1ee7b2b0-84c9-4f09-919e-32fd18ef361f_1294x709.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Oura didn&#8217;t forget to include warnings. The cover of that getting started document tells readers there&#8217;s valuable info inside. The title &#8212; <strong>&#8220;Stuff you should know&#8221; </strong>&#8212; screams it loudly in large type (in both English and French). </p><p>Someone at Oura wrote that <em>stuff. And perhaps more telling, </em>someone at Oura approved printing that same <em>stuff</em> at a size I couldn&#8217;t read without magnification. </p><blockquote><p>One thing is clear: <strong>There&#8217;s something wrong with that </strong><em><strong>stuff</strong></em><strong>.</strong></p></blockquote><h2>If This Info Is Online, Why Does Print Size Matter?</h2><p>Some readers will say the booklet&#8217;s available online, where anyone can enlarge the content. That&#8217;s true: Oura&#8217;s help center hosts <strong><a href="https://ouraringhelp.zendesk.com/hc/article_attachments/52097895480083">a PDF of it</a></strong>. But that helps only those who figure out where to find it and how to enlarge it (tasks they should not have to perform in a so-called &#8220;frictionless&#8221; experience.<br><br>And, it doesn&#8217;t make the printed getting started guide Oura provided in the product package any easier for customers to read. </p><p>The guide is provided to customers inside the box, and it tells customers who can actually see the text (despite it&#8217;s teeny tiny text size) to <strong>&#8221;read through it carefully</strong> <strong>to</strong> <strong>use the ring safely and get the best experience&#8221;</strong>, in the same tiny font size. <br><br>While using the Oura help site I also discovered that the printed getting started guide omits some important safety instructions that Oura does include online. </p><p>Oura&#8217;s <strong><a href="https://support.ouraring.com/hc/en-us/articles/360025428394-Product-Safety-Use">Product Safety &amp; Use</a></strong> article tells customers to: </p><ul><li><p><strong>seek immediate medical attention</strong> if a <strong>child swallows the ring</strong>, and to </p></li><li><p><strong>stop trying to remove a stuck ring</strong> if the finger is very painful, swollen, or discolored</p></li></ul><p>It also <strong>advises against:</strong></p><ul><li><p><strong>scuba diving</strong> with the ring, or </p></li><li><p><strong>keeping it underwater for more than twelve hours</strong></p></li></ul><p>I didn&#8217;t find any of this safety information in the booklet&#8217;s English safety section; even with the help of a magnifying glass &#128269;. So, <strong>inconsistent messaging is also a problem between the print and online product info.</strong> </p><p>That&#8217;s fodder for another blog post.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!GAe0!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!GAe0!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 424w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 848w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!GAe0!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg" width="1456" height="1092" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1092,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2577472,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/jpeg&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224514037?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00f0b952-fe51-4461-bf9d-e80f8847937b_4032x3024.jpeg&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!GAe0!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 424w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 848w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!GAe0!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F61585d2f-a9af-472c-a60e-dfc75c4cb957_4032x3024.jpeg 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/i-couldnt-read-the-safety-warnings">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Understanding Application Programming Interfaces]]></title><description><![CDATA[Learn how APIs connect apps and services behind the scenes so they can share data and features reliably.]]></description><link>https://www.thecontentwrangler.com/p/understanding-application-programming</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/understanding-application-programming</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 16 Nov 2026 14:31:19 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substack-video.s3.amazonaws.com/video_upload/post/224505341/bed77022-e5e2-4262-ac6a-70a866d543ce/transcoded-00001.png"/><content:encoded><![CDATA[<p>An excellent plain language explainer video to help you understand Application Programming Interfaces &#8212;&nbsp;from our friends at <strong><a href="https://commoncraft.com/">CommonCraft</a></strong>.</p>
      <p>
          <a href="https://www.thecontentwrangler.com/p/understanding-application-programming">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[AI Can Produce Documentation Fast, But Can You Trust What It Produces?]]></title><description><![CDATA[In this Heretto video, learn how structured content helps documentation teams maintain accuracy, control, and consistency as AI becomes part of content production and delivery]]></description><link>https://www.thecontentwrangler.com/p/ai-can-produce-documentation-fast</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/ai-can-produce-documentation-fast</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 13 Nov 2026 14:31:28 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!4ibg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png"/><content:encoded><![CDATA[<p>Artificial intelligence (AI) has made it much easier and significantly less expensive to produce words. But producing more content introduces a familiar problem: </p><blockquote><p><strong>How do we make sure that what gets published is accurate, appropriate for the intended audience, and safe to use?</strong></p></blockquote><p>As we introduce AI into our product information and technical documentation workflows, we need trustworthy ways to verify AI-generated content, track changes, manage approvals, and ensure that both human customers and AI agents receive relevant information.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!4ibg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!4ibg!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!4ibg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1978407,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224355125?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!4ibg!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!4ibg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67b5c806-3ab8-403e-99b5-4386397f41a0_1672x941.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>In <strong><a href="https://youtu.be/oNSRBOymoeQ">Trusted Documentation for AI Agents and Humans at Scale</a></strong> (video below), Heretto explores how <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-technical-writers-must-evolve?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">semantic structured content</a></strong> and <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-organizations-invest-in-a-ccms?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">component content management</a></strong> can help us address challenges like these.</p><p>The video examines how structured content makes information easier to trace, review, approve, and reuse. It also explains why maintaining a reliable system of record &#8212; a <strong><a href="https://www.heretto.com/blog/single-source-of-truth">single source of truth</a></strong> &#8212; matters when we want to automate our documentation processes without sacrificing our editorial oversight.</p><div class="native-video-embed" data-component-name="VideoPlaceholder" data-attrs="{&quot;mediaUploadId&quot;:&quot;7b557897-5185-4dc9-b592-5acaa3aa36eb&quot;,&quot;duration&quot;:null}"></div><p>For tech writers, there&#8217;s another important consideration: delivering the correct information for a particular product, version, audience, language, locale, or channel. Those distinctions become increasingly important when we allow AI agents retrieve documentation and answer questions or perform tasks on behalf of our customers.</p><p>If you&#8217;re exploring AI-assisted documentation production, or wondering how your existing content infrastructure will support AI agents, <strong><a href="https://youtu.be/oNSRBOymoeQ?si=13LNHYPiLDPyB1oe">this video</a></strong> offers a useful look at the capabilities you&#8217;ll need. &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p><p></p>]]></content:encoded></item><item><title><![CDATA[[AI Rebounding] What Employers Learn When They Ask People Back After AI-Related Job Cuts]]></title><description><![CDATA[Some leaders underestimated the context and oversight certain jobs require &#8212; tech writers can help make that work visible to them]]></description><link>https://www.thecontentwrangler.com/p/ai-rebounding-what-employers-learn</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/ai-rebounding-what-employers-learn</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 12 Nov 2026 13:31:42 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!xti_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png"/><content:encoded><![CDATA[<p>Fortune magazine <strong><a href="https://fortune.com/2026/11/09/ai-rebounding-20-us-workers-replaced-higher-pay-job-security/">reported</a></strong> (November 9, 2026) that nearly one-in-five employed US adults surveyed by talent assessment firm SHL said their employer had replaced them with AI and later asked them to return. </p><p>SHL calls the pattern &#8220;<strong><a href="https://bestpracticeinstitute.org/workplace-report/the-ai-rebound">AI rebounding</a></strong>.&#8221;</p><p>Tech writers have heard plenty of predictions over the years about AI replacing their jobs. These survey results offer a reason to examine what employers may overlook when deciding which work to automate. </p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!xti_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!xti_!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!xti_!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!xti_!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!xti_!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!xti_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1898372,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/224350078?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!xti_!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!xti_!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!xti_!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!xti_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5d3f6463-d283-4012-8ab2-a82dbb0a55d0_1672x941.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What The Surveys Found</h2><p><strong><a href="https://www.shl.com/assets/premium-content/talent-mobility-at-work-in-2026-report-en-v3.pdf">SHL surveyed 2,036 employed adults</a></strong> (in the US and UK) in June and July of 2026. Among US respondents, 19.1% said they had been replaced by AI and later asked to return by the same employer. Across both countries the figure was 16%. SHL also asked what workers would want if asked back: 51% said a substantial raise, 42% said written job-security guarantees, and 40% said transparency about how AI would be used in their role.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/ai-rebounding-what-employers-learn">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Where AI’s Tech Slang Comes From, And Who It Leaves Out]]></title><description><![CDATA[Nicole Michaelis asks who named AI&#8217;s terms, and what those names assume about the people who hear them]]></description><link>https://www.thecontentwrangler.com/p/where-ais-tech-slang-comes-from-and</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/where-ais-tech-slang-comes-from-and</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 11 Nov 2026 14:30:54 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!TMAV!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png"/><content:encoded><![CDATA[<p>In a single meeting, <strong><a href="https://substack.com/@nicolemichaelis">Nicole Michaelis</a></strong> heard that someone had &#8220;one-shotted&#8221; a prototype, that the team should spin up a &#8220;tiger team,&#8221; and that the customer needed a &#8220;forward-deployed engineer.&#8221; Nobody blinked. She nodded along without knowing what she had agreed to, then looked into the terms&#8217; origins. She reports what she found in <strong><a href="https://eggwoman.substack.com/p/who-gets-to-name-the-future">&#8220;Who gets to name the future?&#8221;</a></strong></p><p>Michaelis credits <strong><a href="https://blog.palantir.com/a-day-in-the-life-of-a-palantir-forward-deployed-software-engineer-45ef2de257b1">Palantir</a></strong> with coining &#8220;forward-deployed engineer,&#8221; drawing on the military idea of a soldier posted close to the action. She cites a <strong><a href="https://saemobilus.sae.org/papers/program-management-design-development-640548">1964 aerospace paper</a></strong><a href="https://saemobilus.sae.org/papers/program-management-design-development-640548"> </a>as the earliest documented use of &#8220;tiger team.&#8221; She links &#8220;frontier model&#8221; to <strong><a href="https://www.sciencehistory.org/stories/magazine/the-rise-and-fall-of-vannevar-bush/">Vannevar Bush</a></strong>&#8217;s <strong><a href="https://www.govinfo.gov/content/pkg/GOVPUB-PR32_400-e7966ee70a4f7b47f862431c9776f727/html/GOVPUB-PR32_400-e7966ee70a4f7b47f862431c9776f727.htm">1945 case</a></strong> for science as &#8220;the endless frontier,&#8221; a metaphor she says was borrowed from the closing of the American West. In her account, &#8220;cracked&#8221; and &#8220;one-shotted&#8221; come from gaming slang, while &#8220;AI native&#8221; remixes &#8220;digital native,&#8221; a term <strong><a href="https://en.wikipedia.org/wiki/Marc_Prensky">Marc Prensky</a></strong> introduced in a <strong><a href="https://cosc-480-ucd-f16.github.io/COSC-480-UCD/files/Prensky2001-DigitalNativesDigitalImmigrants.pdf">2001 article</a></strong>.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!TMAV!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!TMAV!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!TMAV!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2073674,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223821504?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!TMAV!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!TMAV!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0882f57a-e8f4-4536-8717-89861dfc408d_1672x941.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Michaelis argues that these AI vocabulary words carry assumptions about who belongs in tech (and who doesn&#8217;t). She isn&#8217;t claiming the words cause the gaps she describes in AI hiring and use, though she suspects they don&#8217;t help. She also points to women whose work shaped computing and went unrecognized. <strong><a href="https://www.eniac.vc/writings/remembering-the-eniac-six">Six women</a></strong> programmed the <strong><a href="https://www.engineering.upenn.edu/about/history-heritage/eniac/">Electronic Numerical Integrator and Computer</a></strong> (ENIAC), and they weren&#8217;t introduced at the machine&#8217;s public unveiling in 1946. <strong><a href="https://www.linkedin.com/in/fei-fei-li-4541247/">Fei-Fei Li</a></strong> was first author of a <strong><a href="https://pubmed.ncbi.nlm.nih.gov/16566508/">2006 paper</a></strong> on <strong><a href="https://en.wikipedia.org/wiki/One-shot_learning_(computer_vision)">one-shot learning</a></strong>, which Michaelis credits with putting the idea on the AI map.</p><p>I advocate for inclusive language and worked on a chapter about it for an upcoming book on plain language in business. One plain-language question is whether readers can understand a term. Michaelis&#8217;s essay adds a second: <strong>what does the term assume about its reader?</strong> A term can be clear and still suggest who belongs.</p><p>We tech writers choose product terms, so the second question applies to our work too. Michaelis suggests &#8220;fluent&#8221; in place of &#8220;native&#8221;: a skill people develop, rather than an identity some people are presumed to have. </p><blockquote><p>Terminology reviews should ask both questions: <br><br><strong>1) Is this label clear, and <br>2) What does it assume about the person reading it?</strong></p></blockquote><p>Read Michaelis&#8217;s <strong><a href="https://eggwoman.substack.com/p/who-gets-to-name-the-future">full post</a></strong>, and share it with someone who names or reviews product language. &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[WTFM: A Practical Guide For Standing Up Docs At A Startup]]></title><description><![CDATA[CT Smith&#8217;s guide teaches new documentation owners what to build first, using stories from the companies where she learned it]]></description><link>https://www.thecontentwrangler.com/p/wtfm-a-practical-guide-for-standing</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/wtfm-a-practical-guide-for-standing</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 09 Nov 2026 13:30:47 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!NX6G!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png"/><content:encoded><![CDATA[<p>I met <strong><a href="https://www.linkedin.com/in/ctsmithdocs/">CT Smith</a></strong> while looking for guests for <em>Coffee and Content</em>, the talk show I co-host with <strong><a href="https://www.linkedin.com/in/patrickbosek/">Patrick Bosek</a></strong> of <strong><a href="https://www.heretto.com">Heretto</a></strong>. Partway through our conversation, she mentioned a book she had written: <em><strong><a href="https://wtfmbook.com/">WTFM: A practical guide for standing up docs at a startup</a></strong></em>.</p><blockquote><p><em>WTFM</em> is written for the people who end up owning documentation without choosing the job: founders, support leads, and the engineer who keeps answering the same question in Slack. </p></blockquote><p>Smith has built documentation programs at companies ranging from a seed-stage fintech to a recently public analytics company, and she watched an acquired startup&#8217;s docs grow into a content team of hundreds of writers and tens of thousands of pages. She wrote this book for the moment <em>before</em> that kind of growth, and she kept it short enough to read in one sitting.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!NX6G!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!NX6G!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 424w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 848w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 1272w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!NX6G!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png" width="1456" height="1187" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1187,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:420520,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223520112?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!NX6G!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 424w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 848w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 1272w, https://substackcdn.com/image/fetch/$s_!NX6G!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1a2693f1-df25-483d-8d68-0d0d5da0c4b7_1886x1538.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What A First-Time Documentation Manager Gets From The Book</h2><p>Most of Smith&#8217;s recommendations arrive with stories from her own career, which is what makes them stick. Her <strong><a href="https://wtfmbook.com/chapters/business-case-for-docs/">case for funding documentation</a></strong> opens with a contract stalled in redlines until the customer&#8217;s legal team saw a specific feature publicly documented. She then hands readers a <strong><a href="https://wtfmbook.com/chapters/business-case-for-docs/#cost-savings">worksheet</a></strong> that turns support tickets and engineering escalations into a monthly dollar figure leadership can find value in.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!IJvC!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!IJvC!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 424w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 848w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 1272w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!IJvC!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png" width="1250" height="1116" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/b965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1116,&quot;width&quot;:1250,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:113314,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223520112?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!IJvC!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 424w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 848w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 1272w, https://substackcdn.com/image/fetch/$s_!IJvC!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb965b3a4-6ef0-46a7-b2c1-f8b2af3e284c_1250x1116.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><strong>Total monthly avoidable cost calculator.</strong></figcaption></figure></div><p>Her argument for writing decisions down rests on a rule in her own style guide that nobody could explain. She traced it to a year-old Slack message and learned it existed to work around a bug that had since been fixed. Her AI chapter, &#8220;<strong><a href="https://wtfmbook.com/chapters/ai-doesnt-care-about-your-customers/">AI Doesn&#8217;t Care About Your Customers</a></strong>,&#8221; recommends using AI to build ordinary tools such as link checkers and validators, so routine checks don&#8217;t need AI, and treats every AI draft as unpublishable until a subject matter expert signs off. </p><p>She also tests her own writing advice against AI systems and publishes the results.</p><p>When the docs outgrow volunteers, Smith makes the case for hiring a writer to own the whole program, with a <strong><a href="https://wtfmbook.com/chapters/hire-a-writer/">headcount pitch</a></strong> that frames the hire as making documentation &#8220;someone&#8217;s job instead of everyone&#8217;s problem.&#8221;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Bkiw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Bkiw!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Bkiw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/aea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1408441,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223520112?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Bkiw!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!Bkiw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faea9f9b8-5c0c-4fd6-926c-d4e57290a395_1672x941.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Why Experienced Documentation Leaders Should Read This Book</h2><p>Experienced pros will find value in two places. Smith&#8217;s stories and the included worksheet give them language to speak to colleagues who haven&#8217;t run a tech docs program before. </p><p>In <strong><a href="https://wtfmbook.com/parts/part-5/">Chapter 5</a></strong>, Smith describes documenting version 2 of an API whose supporting service had no version 2. The note saying so was accurate, but it sat deep in the guide, and customers started the task before they reached it. Her fix was to move the condition to the top. Her own testing found that vague scope language such as &#8220;where applicable&#8221; dropped AI accuracy from 97 percent to as low as 48 percent.</p><p>That fix works on a page a person reads from the top. AI retrieval systems pull chunks out of pages, and a condition placed at the top can be separated from the step it governs. As products and versions multiply, keeping applicability attached to each instruction becomes one of the harder technical documentation problems. Smith&#8217;s small story is a good way to explain it to colleagues who assume AI accuracy depends only on whether the docs are correct.</p><h2>Who Should Read <em>WTFM?</em></h2><p>Anyone who has inherited a documentation site, or is about to fund one, should read this freely available online book. Smith says plainly that it <em>isn&#8217;t a definitive guide </em>to writing for AI, information architecture, or doc testing; she includes a <strong><a href="https://wtfmbook.com/backmatter/reading-list/">reading list</a></strong> for those subjects. What the book does is show new documentation owners what to build first and explains why.</p><p>Smith ends the book with a Tom Waits line about not letting the weeds grow taller than the garden. In a startup&#8217;s docs, the weeds are usually outdated pages and decisions nobody wrote down. As the company grows, a hardier weed shows up: instructions that are correct, but reach customers whose product version or setup they don&#8217;t apply to. Smith&#8217;s advice gives doc teams a good place to start to tackle both.</p><p>Read the full text at <strong><a href="https://wtfmbook.com/">wtfmbook.com</a></strong>, or buy a copy through the link on the site. &#129312;</p><p></p><p></p>]]></content:encoded></item><item><title><![CDATA[The Semantic Backbone: What It Is And What It Means For Technical Documentation]]></title><description><![CDATA[How connecting concepts, content, and relationships can improve AI answer accuracy and make technical documentation more useful]]></description><link>https://www.thecontentwrangler.com/p/the-semantic-backbone-what-it-is</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-semantic-backbone-what-it-is</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 06 Nov 2026 13:31:53 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!IEiR!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png"/><content:encoded><![CDATA[<p>by <strong><a href="https://www.linkedin.com/in/helmutnagy/">Helmut Nagy</a> </strong>(with some help from the <strong><a href="http://ask.graphwise.ai/">Graphwise Knowledge Graph</a></strong> in <strong><a href="https://www.claude.ai">Claude</a></strong>)</p><p>Documentation isn&#8217;t created solely for people anymore. It&#8217;s created to be read by machines (AI assistants) as well as by humans. Chatbots, search tools, and agents should be able to use it, find the right topics, combine them, and generate trustworthy answers to questions asked of them. When terminology and <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-metadata-is-everybodys-problem?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">metadata</a></strong> are inconsistent across information sources, those AI-generated answers become incongruent too, even if each topic is correct on its own.</p><p>This is one reason many AI pilots work well in a demo but become unreliable at scale. A <strong><a href="https://graphwise.ai/fundamentals/what-is-a-semantic-backbone/">semantic backbone</a></strong> addresses the problem by giving content a shared, machine-readable layer of meaning.</p><p>This post explains the concept and what it means for documentation teams, with a short example from the Graphwise <strong><a href="https://graphwise.ai/use-cases/knowledge-hub/">Knowledge Hub</a></strong>.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!IEiR!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!IEiR!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!IEiR!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png" width="1456" height="745" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:745,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1502972,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/222388480?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!IEiR!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!IEiR!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0903aa2-d896-4e88-93f3-fbf965117898_1752x897.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What Is A Semantic Backbone?</h2><p>A semantic backbone is a shared knowledge infrastructure. At its core, it&#8217;s an <strong><a href="https://graphwise.ai/?utm_source=adwords&amp;utm_medium=ppc&amp;utm_campaign=Search%20Graphdb&amp;utm_term=ai%20graph%20database&amp;utm_content=the_graphwise_sandbox_ai_powered&amp;hsa_acc=5361285845&amp;hsa_cam=22734182060&amp;hsa_grp=184629223909&amp;hsa_ad=772624969407&amp;hsa_src=g&amp;hsa_tgt=kwd-2505219722089&amp;hsa_kw=ai%20graph%20database&amp;hsa_mt=p&amp;hsa_net=adwords&amp;hsa_ver=3&amp;gad_source=1&amp;gad_campaignid=22734182060&amp;gbraid=0AAAAA-4mb5bigxSw3U22GJks9C9C1z8Jl&amp;gclid=CjwKCAiAhqHXBhAXEiwATbksU5jnZWbIBqsJqDE1BsJAgX17O4iqAPM5W1UeNyyA_NWmiZJO9wVuBxoCXKMQAvD_BwE">enterprise knowledge graph</a></strong>: a network of the organization&#8217;s language, business concepts, entities, and the relationships between them. Taxonomies, ontologies, and rules govern the graph, so that people, applications, and AI systems work all with the same definitions.</p><p><strong>In practice, a semantic backbone can be described in terms of four building blocks:</strong></p><ol><li><p><strong>Taxonomies</strong> organize the organization&#8217;s language. They manage things like preferred terms and synonyms and also how concepts are related. SKOS is the common W3C standard for them.</p></li><li><p><strong>Ontologies</strong> describe an organization&#8217;s business concepts and how they are related and described. OWL is the common W3C standard for them.</p></li><li><p><strong>The knowledge graph</strong> connects these models with actual content and data: documents, products, components, and support cases. There are existing schemas like iiRDS and DITA that can help with that.</p></li><li><p><strong>Governance</strong> keeps the backbone reliable through validation rules, provenance, policies, and human review. SHACL is the W3C standard for expressing validation rules in the knowledge graph.</p></li></ol><p>This distinguishes a Semantic Backbone from a simple metadata or reporting layer. It is not a thin set of mappings for one tool, but a governed model of meaning that any system can reuse.</p><p>Instead of building separate semantic layers for each app, a single backbone serves search, analytics, content delivery, and AI tools. The Graphwise Semantic Backbone <strong><a href="https://graphwise.ai/resources/white-paper/the-enterprise-semantic-backbone-a-foundation-for-reliable-and-scalable-agentic-ai/">whitepaper</a></strong> describes the backbone&#8217;s architecture in six layers (Fig. 1) with a cross-cutting <em><strong>Trust</strong> </em>layer for governance.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!1Zld!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!1Zld!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 424w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 848w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 1272w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!1Zld!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png" width="1344" height="1102" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1102,&quot;width&quot;:1344,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:null,&quot;alt&quot;:&quot;Semantic Backbone architecture &#183; 6 layers + Trust&quot;,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="Semantic Backbone architecture &#183; 6 layers + Trust" title="Semantic Backbone architecture &#183; 6 layers + Trust" srcset="https://substackcdn.com/image/fetch/$s_!1Zld!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 424w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 848w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 1272w, https://substackcdn.com/image/fetch/$s_!1Zld!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7dbd0ff7-4e43-4165-b65d-6ecce0fd73da_1344x1102.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p style="text-align: center;"><strong><sup>Fig. 1: Semantic Backbone architecture &#183; 6 layers + Trust</sup></strong></p><p>For AI systems, well-structured product information can provide grounding: relevant, trustworthy evidence that helps tie answers to their sources. </p><blockquote><p>In a <strong><a href="https://graphwise.ai/blog/from-retrieval-to-reasoning-enhancing-hipporag-with-graph-based-semantics/">Graphwise benchmark on multi-hop questions</a></strong>, this approach reached about 95% accuracy, compared with 79% for vector-based RAG, <strong>roughly four times fewer wrong answers.</strong></p></blockquote><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!y-Uw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!y-Uw!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!y-Uw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png" width="1456" height="745" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/71747823-72e9-4b92-9ef0-202306060724_1752x897.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:745,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1502972,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/222388480?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!y-Uw!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!y-Uw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71747823-72e9-4b92-9ef0-202306060724_1752x897.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What This Means For Documentation Teams</h2><p>Tech docs teams already do much of the groundwork required. Our termbases, topic types, metadata schemes, and reuse strategies are the raw material of the backbone&#8217;s lower layers. Teams that already work with structured content, such as DITA XML, are one step away from producing semantic documentation: <em>components enriched with governed concepts and linked in a graph.</em></p><p><strong>In practice, this affects five areas:</strong></p><ul><li><p><strong>Terminology:</strong> each concept is managed once in a  <strong><a href="https://www.w3.org/TR/skos-reference/">Simple Knowledge Organization System</a></strong> (SKOS) vocabulary, with its preferred term, synonyms, and translations.</p></li><li><p><strong>Reuse:</strong> topics linked to products, versions, and components show where a concept is used, so changes can be traced across all content.</p></li><li><p><strong>Metadata:</strong> fields such as applicability, audience, and lifecycle state refer to governed concepts rather than free text.</p></li><li><p><strong>Findability:</strong> search works by concept, so a query for one term also finds content that uses a synonym.</p></li><li><p><strong>Quality checks:</strong> validation rules, for example in <strong><a href="https://www.w3.org/TR/shacl/">Shapes Control Language</a></strong> (SHACL), can be configured to check required metadata or flag deprecated terms.</p></li></ul><h2>An Example: The Graphwise Knowledge Hub</h2><p>Graphwise built a semantic backbone for its <strong><a href="https://graphwise.ai/use-cases/knowledge-hub/">Knowledge Hub</a></strong>, with technical documentation as one of the teams involved. They started with <strong><a href="https://www.w3.org/TR/skos-reference/">SKOS</a></strong>, a common data model for sharing and linking knowledge systems that includes taxonomy for consistent tagging, ontologies, and automated ingestion that tags and links content from DITA, DocBook, Markdown, PDF, and tools such as Paligo, Heretto, Wordpress and Google Drive. </p><p>AI assistants answer questions from the graph using <strong><a href="https://graphwise.ai/graphwise-graphrag/">GraphRAG</a></strong>. About 5% of the backbone was built manually; graph automation and LLM support handled the rest.</p><div class="native-video-embed" data-component-name="VideoPlaceholder" data-attrs="{&quot;mediaUploadId&quot;:&quot;eee835ca-df22-4b62-a158-d560cbd23123&quot;,&quot;duration&quot;:null}"></div><h2>Getting Started</h2><p>A semantic backbone doesn&#8217;t need to be built all at once. It&#8217;s best built incrementally, starting with a high-value use case. For content-heavy environments such as technical documentation, building a taxonomy is typically the initial step; for structured data, an ontology may come first. Linked content and AI applications follow, so each step delivers value on its own. For doc teams, an existing termbase and metadata scheme are natural starting points.</p><p>You can try the Graphwise Knowledge Hub at <strong><a href="https://ask.graphwise.ai/">ask.graphwise.ai</a>.</strong> Related assistants are available in the Graphwise documentation at <strong><a href="https://help.graphwise.ai/">help.graphwise.ai</a></strong> and at <strong><a href="https://graphwise.ai/ask-marta/">graphwise.ai/ask-marta</a></strong>.</p><blockquote><p><strong>Webinar:</strong> In our November 19, 2026 webinar &#8212; <strong><a href="https://web.bigmarker.com/heretto/the-graphwise-knowledge-hub-how-we-developed-our-semantic-backbone-and-what-it-means-for-technical-documentation">The Semantic Backbone: What It is and What It Means for Documentation</a> &#8212;</strong> you can learn about these topics in more detail, with practical examples from technical documentation. </p></blockquote><h2><strong>Sources</strong></h2><ul><li><p><strong><a href="https://graphwise.ai/resources/white-paper/the-enterprise-semantic-backbone-a-foundation-for-reliable-and-scalable-agentic-ai/">The Enterprise Semantic Backbone: A Foundation for Reliable and Scalable Agentic AI</a></strong><a href="https://graphwise.ai/resources/white-paper/the-enterprise-semantic-backbone-a-foundation-for-reliable-and-scalable-agentic-ai/"> </a>(Graphwise whitepaper)</p></li><li><p><strong><a href="https://graphwise.ai/fundamentals/what-is-a-semantic-backbone/">What Is a Semantic Backbone?</a></strong> (Graphwise Fundamentals)</p></li></ul><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[A New Podcast Puts Content At The Center Of The Enterprise AI Conversation]]></title><description><![CDATA[The first episodes include a Forrester analyst on answer engines and a Red Hat content leader on the AI tools her team built]]></description><link>https://www.thecontentwrangler.com/p/a-new-podcast-puts-content-at-the</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/a-new-podcast-puts-content-at-the</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 05 Nov 2026 13:30:53 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!K0OI!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png"/><content:encoded><![CDATA[<p><strong><a href="https://podcasts.apple.com/us/podcast/content-powers-ai/id6827753041">Content Powers AI</a></strong>, a new podcast from <strong><a href="https://content-science.com/">Content Science</a></strong>, is live. I've been waiting for it since <strong><a href="https://www.linkedin.com/in/leenjones/">Colleen Jones</a></strong>, president of Content Science and author of <em><strong><a href="https://content-science.com/publications/content-advantage/">The Content Advantage</a></strong></em>, told me it was coming during one of our conversations. Jones hosts the show and uses it to help us understand what has to be true inside an organization for AI to work effectively, especially at scale.</p><div class="native-video-embed" data-component-name="VideoPlaceholder" data-attrs="{&quot;mediaUploadId&quot;:&quot;5c9a79f5-f601-44ce-a171-8c84a3503ea2&quot;,&quot;duration&quot;:null}"></div><h2>The Launch Episode</h2><p>In the 9-minute <strong><a href="https://podcasts.apple.com/us/podcast/lets-talk-about-what-really-powers-enterprise-ai-content/id6827753041?i=1000798428942">opening episode</a></strong>, Jones argues that enterprise AI needs content strategy, operations, and governance to get past demos and pilots. The content she has in mind includes product information, policies, research, metadata, documentation, and institutional knowledge, along with web pages and marketing copy. </p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p>She previews upcoming conversations with people from organizations including <strong><a href="https://www.homedepot.com/">The Home Depot</a></strong><a href="https://www.homedepot.com/"> </a>and <strong><a href="https://www.mayoclinic.org/">Mayo Clinic</a></strong>, and Content Science&#8217;s list of planned topics includes content architecture, structured content, AI readiness, and agentic workflows.</p><p>Jones cites Content Science&#8217;s <strong><a href="https://content-science.com/content-operations-study/">2025 content operations study</a></strong>, in which 86% of participants report using AI in at least some areas of ContentOps with 29% reporting moderate or fast progress scaling adoption. One cause of that gap is a problem tech docs teams deal with routinely. An AI assistant can retrieve the right installation topic and still give a wrong answer (incorrect instructions) if the topic never says which product version it covers or fails to connect the topic to pre-requisites, warnings, and other contextually relevant facts. <br><br>Waiting for a newer language model to be released cannot overcome this missing information.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!K0OI!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!K0OI!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!K0OI!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png" width="1456" height="745" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:745,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1486864,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223499067?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!K0OI!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!K0OI!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bcee7a6-c07a-4496-a7af-da690783b463_1752x897.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><a href="https://podcasts.apple.com/us/podcast/content-powers-ai/id6827753041">Content Powers AI</a> podcast from <a href="https://content-science.com/">Content Science</a> &#8212;&nbsp;listen in on your favorite podcast delivery service.</figcaption></figure></div><h2>What The First Guests Say That Should Matter To Technical Documentation Teams</h2><p><strong><a href="https://www.linkedin.com/in/chuckgahun/">Chuck Gahun</a></strong>, a principal analyst at <strong><a href="https://www.forrester.com/bold/">Forrester</a></strong>, is the guest on <strong><a href="https://podcasts.apple.com/us/podcast/behind-the-ai-hype-enterprise-content-realities-with/id6827753041?i=1000798428784">episode 2</a></strong>. During this show he says AI adoption is moving more slowly than tech leaders&#8217; claims suggest. According to Gahun, &#8220;published content is not the last mile anymore,&#8221; because a machine now sits on top of it and generates a response tailored to whoever asked, drawing on third-party reviews and competitor information along with the content itself. </p><p>A customer who asks an answer engine how to configure a product may rely solely on the engine&#8217;s response and never see the help topic or documentation portal it came from.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!GIzL!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!GIzL!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!GIzL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png" width="1456" height="745" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/efc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:745,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1447012,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223499067?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!GIzL!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 424w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 848w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 1272w, https://substackcdn.com/image/fetch/$s_!GIzL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fefc5f57f-3562-46f3-9367-464bf254cb79_1752x897.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><strong><a href="https://podcasts.apple.com/us/podcast/ai-authenticity-the-future-of-content-teams-with/id6827753041?i=1000798428693">Episode 3</a></strong> features <strong><a href="https://www.linkedin.com/in/laurarbarnes/">Laura Barnes</a></strong>, senior director of global content at <strong><a href="https://www.redhat.com/en/hybrid-cloud-solutions?sc_cid=RHCTN0250000435836&amp;gclsrc=aw.ds&amp;gad_source=1&amp;gad_campaignid=20301154521&amp;gbraid=0AAAAADsbVMRHVAOJ0uDa7_ZV-hKTk6MuS&amp;gclid=CjwKCAiAzKvXBhBAEiwABLl9AuZCFAznr9Ng105GHxW0chpmdQRRnQJw55KvZUnDImI6WDtXHwM-KBoCZ3gQAvD_BwE">Red Hat</a></strong>. Her group began its AI work by asking which content tasks people wanted to stop doing, and one result is a metadata assistant that reads a page and suggests tags. Her team reports it saves 20 to 30 minutes per page. </p><p>Barnes says research on what powers AI points to <strong><a href="https://www.thecontentwrangler.com/p/why-technical-writers-must-evolve">semantic structured content</a></strong>. She also describes how Red Hat&#8217;s documentation team began mapping docs to specific jobs to be done, with jump links, so customers can easily find what they need. Her marketing team is now aligning its own jobs-to-be-done mapping with the documentation team&#8217;s.</p><h2>Why Tech Writers Should Listen &#127911;</h2><p>The problems these episodes describe come down to questions documentation teams settle for every release, such as which version applies to a given customer, what has to be true before a procedure works, which exceptions matter, and who updates the source docs when the product changes. </p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Jn1E!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Jn1E!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Jn1E!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/af38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1452467,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/223499067?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Jn1E!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 424w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 848w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 1272w, https://substackcdn.com/image/fetch/$s_!Jn1E!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf38b362-0d52-4bd3-8d57-2a896f808100_1672x941.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><blockquote><p>An AI system can use those answers only if they&#8217;re in the content it reads, and documentation teams usually write that content.</p></blockquote><p>If Gahun is right that published content is no longer the last mile, page views on a help site no longer show whether documentation reached the person who needed it. Documentation teams will need different measures of performance success.</p><p>Content Powers AI is available now. <a href="https://review.content-science.com/what-really-powers-enterprise-ai-content/">Watch or listen to the launch episode</a> on Content Science Review, or find the show on <a href="https://podcasts.apple.com/us/podcast/content-powers-ai/id6827753041">Apple Podcasts</a>. &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[What If Every AI Model Came With A Nutrition Label?]]></title><description><![CDATA[Researchers have made them for ten leading language models, and what they reveal should interest anyone who documents AI products]]></description><link>https://www.thecontentwrangler.com/p/what-if-every-ai-model-came-with</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-if-every-ai-model-came-with</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 28 Oct 2026 12:30:57 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!wY9S!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png"/><content:encoded><![CDATA[<p><strong><a href="https://www.linkedin.com/in/jurgen-gravestein/">Jurgen Gravestein</a></strong>, who writes the newsletter <em><strong><a href="https://jurgengravestein.substack.com/">Teaching Computers How to Talk</a></strong></em>, recently <strong><a href="https://jurgengravestein.substack.com/p/why-large-language-models-need-nutrition">covered a research project</a></strong> that borrows an idea from food packaging: give people a standardized way to compare AI models before choosing one.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!NJsB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!NJsB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 424w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 848w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 1272w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!NJsB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png" width="1456" height="766" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:766,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1752344,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/221040222?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!NJsB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 424w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 848w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 1272w, https://substackcdn.com/image/fetch/$s_!NJsB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd02c3332-4741-498e-b9e8-712502042e8f_2612x1374.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What the Researchers Built</h2><p><strong><a href="https://www.media.mit.edu/">MIT Media Lab</a></strong> and researchers at other institutions created <strong><a href="https://impactbench.media.mit.edu/nutrition">ImpactBench</a></strong>, an open benchmark for evaluating whether AI models support or undermine users&#8217; wellbeing. It covers psychological, physical, and social outcomes through 809 metrics drawn from 26 benchmarks. Researchers evaluated ten models in 48,540 simulated conversations.</p><p>Across those evaluations, the models promoted behaviors the benchmark defines as <strong>desirable 68.7% of the time</strong> and <strong>avoided identified harms 53.1% of the time</strong>. Those are aggregate results, not scores for any single model. </p><blockquote><p><strong><a href="https://arxiv.org/abs/2610.20690">The research paper</a></strong> describes the evaluation method and its limits.</p></blockquote><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>Why Gravestein Says It Matters</h2><p>Gravestein points out that regular chatbot users often don't realize how easily these tools can make things up or just tell people what they want to hear. Being upfront about how different AIs act can help people choose the right one to use, he says.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wY9S!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wY9S!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 424w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 848w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 1272w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!wY9S!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png" width="881" height="1172" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1172,&quot;width&quot;:881,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:219876,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/221040222?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbdcd5157-c2ae-4f52-be05-614e9ebb2099_883x1174.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!wY9S!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 424w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 848w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 1272w, https://substackcdn.com/image/fetch/$s_!wY9S!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F392c8b5c-1907-4ae5-89ee-ba33ab3c7811_881x1172.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Claude Sonnet 5: What One Label Shows</h2><p>ImpactBench presents complex evaluation results in a familiar format: a compact <strong><a href="https://impactbench.media.mit.edu/nutrition">nutrition-style label</a></strong> with an overall grade and separate categories beneath it.</p><p>I found the label for <strong><a href="https://www.anthropic.com/news/claude-sonnet-5">Claude Sonnet 5</a></strong>. The <strong><a href="https://www.anthropic.com/">Anthropic</a></strong>-produced model received an overall grade of C+. Fourteen category grades were grouped by whether they avoided negative impact or promoted positive impact. Arrows beside the grades invite readers to do further learning. There&#8217;s also an option to access the &#8220;full evaluation.&#8221;</p><p>Tech writers use this <strong><a href="https://www.nngroup.com/articles/progressive-disclosure/">progressive disclosure</a></strong>-type approach to content design. Offer up a useful summary, then make the detail available to readers who need it. Explaining how an AI feature behaves, including its known limitations, belongs in that same documentation practice.</p><p><strong>&#128221; Note:</strong> The category grades displayed in the AI nutrition label are more useful than the overall impact score on its own. Overall, Claude Sonnet 5 received a C+ score, with an A- for avoiding factual hallucination and a D- for promoting learning and skill development. </p><h2>What Tech Writers Can Do With It</h2><p>AI documentation usually tell you what a tool can do, but rarely does it explain what happens when it makes mistakes or hits its limits. For teams writing this content, the ImpactBench label is a great example of how to show this information clearly so users can quickly compare different tools.</p><p>Keep in mind that this test has its own limits. It only measures how the AI handles fake conversations about wellbeing. Good scores don&#8217;t guarantee the AI will correctly answer questions about <em>your company&#8217;s products</em>. You still must test it on your own specific tasks and data.</p><p>Finally, any AI label must include a version and a date (this one doesn&#8217;t). AI behavior changes when the system is updated. If we are going to grade AI tools, we need these dates to track and compare those updates over time.&#129312;</p>]]></content:encoded></item><item><title><![CDATA[Valid XML, Missing Context: What Rockley’s ‘Unified Content Strategy’ Continues To Provide Technical Documentation Teams]]></title><description><![CDATA[Structured content can pass validation and still feed an AI answer engine instructions that don&#8217;t apply. The information-modeling ideas behind unified content strategy show where to look]]></description><link>https://www.thecontentwrangler.com/p/valid-xml-missing-context-what-rockleys</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/valid-xml-missing-context-what-rockleys</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 27 Oct 2026 12:31:07 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!gfqZ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png"/><content:encoded><![CDATA[<p>In 2002, <strong><a href="https://www.linkedin.com/in/annrockley/">Ann Rockley</a></strong>, <strong><a href="https://www.linkedin.com/in/pamelakostur/">Pamela Kostur</a></strong>, and <strong><a href="https://www.linkedin.com/in/steve-manning-1b6805/">Steve Manning</a></strong> published <em><strong><a href="https://www.oreilly.com/library/view/managing-enterprise-content/0735713065/">Managing Enterprise Content: A Unified Content Strategy</a> </strong>(New Riders)</em>. I served as technical editor. Ann and I were also working with a multinational life sciences company at the time. We were helping the company adopt information science-backed methods and techniques to meet its business goals. A major part of that work involved us helping it adopt <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-technical-writers-must-evolve?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">semantic structured content</a></strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-technical-writers-must-evolve?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web"> </a>and <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-organizations-invest-in-a-ccms?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">component content management</a></strong>. </p><p>The goal was a sustainable, scalable approach that would reduce the amount of time required to prepare and submit <strong><a href="https://www.fda.gov/drugs/types-applications/new-drug-application-nda">New Drug Applications</a></strong> to the US Food and Drug Administration (FDA).</p><p>I recently reread <em><strong><a href="https://asistdl.onlinelibrary.wiley.com/doi/pdf/10.1002/meet.1450390165">The Architecture of Content Reuse</a></strong></em><strong>,</strong> a short paper Ann and Steve derived from the book for a panel at the 2002 annual meeting of the <strong><a href="https://www.asist.org/">American Society for Information Science and Technology</a></strong> (ASIST). Reading it 24 years later reminded me how far their ambitions extended beyond cheaper publishing. Reuse is the paper&#8217;s subject, but it also describes information models that identify content elements, what those elements mean, and how they are reused.</p><h2>How Rockley Classified Reuse</h2><p>Most organizations, the authors observed, reused content by copying and pasting it. That works until the content changes and someone has to find every copy. Miss one, and the result is an error.</p><p>They distinguished opportunistic reuse, in which an author chooses to reuse an existing component, from systematic reuse, in which reuse is planned and software inserts components at designated locations. Reused content takes one of three forms. Locked content stays unchanged wherever it appears. Derivative content is adapted from a parent component and stays linked to it, so its author is notified when the parent changes. Nested content holds several reusable elements inside one element, and different information products use different subsets.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!gfqZ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!gfqZ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!gfqZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1549964,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/221013144?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!gfqZ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!gfqZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F57bb12f0-dacc-4a19-bace-7e2e146c7c9d_1536x1024.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>A <em>warning</em> that needs identical and approved wording across all products is a perfect candidate <strong>locked reuse</strong> (where a content component is reused unchanged). A <em>maintenance procedure</em> that is mostly shared but has one configuration-specific step calls for <strong>derivative</strong> or <strong>nested reuse</strong>. </p><p><strong>Derivative reuse</strong> occurs when a reusable content component is edited, that component becomes a derivative [or a &#8220;child&#8221;] of the original &#8220;parent&#8221; element. According to Rockley, a derivative content component &#8220;continues to be related to the original, such that if the original (parent) changes, the author of the derivative (child) element is notified of the change and can decide whether or not to incorporate the change.&#8221;</p><p>Nested reuse occurs when content contains a number of reusable content components contained within another content component. According to Rcokely, &#8220;nested reusable information provides authors with the ability to create content for all the outputs at the same time, thereby providing context and frequently speeding up the authoring process.&#8221;</p><p>The paper&#8217;s information models specify elements, attributes, metadata, and the relationships among content elements. Semantic tags describe what an element is and what it&#8217;s about. Architectural information records where content is reused and how. DTDs, authoring forms, and structural templates enforce a consistent structure. That consistency makes automated processing possible, but it doesn&#8217;t establish that every necessary fact was captured in the content.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>From Unified Content Strategy To Intelligent Content</h2><p>Rockley didn&#8217;t invent structured authoring, <strong><a href="https://www.heretto.com/blog/single-source">single source publishing</a></strong>, or content reuse. She was one of several people at the leading edge of content strategy thinking about them, and with Kostur and Manning she assembled those ideas into a framework technical documentation teams could implement. Its principles became standard practice among teams that went on to adopt the <strong><a href="https://learningdita.com/">Darwin Information Typing Architecture</a></strong> (DITA) XML, <strong><a href="https://help.heretto.com/en/heretto-ccms/heretto-ccms-overview">component content management systems</a></strong> (CCMSs), and automated publishing. And these practices are the foundation upon which many documentation publishing pipelines are built.</p><p>In 2011, Ann and <strong><a href="https://www.linkedin.com/in/jgollner/">Joe Gollner</a></strong> wrote about intelligent content strategy in a <strong><a href="https://asistdl.onlinelibrary.wiley.com/doi/epdf/10.1002/bult.2011.1720370211">special section</a></strong> of the <em>Bulletin of the American Society for Information Science and Technology</em> that <strong><a href="https://www.linkedin.com/in/sethearley/">Seth Earley</a></strong> and I edited. On automation, they wrote, </p><blockquote><p>&#8220;Content must be consciously designed to support it.&#8221;</p></blockquote><p>Ann and I ran the <strong>Intelligent Content Conference</strong> together and <strong><a href="https://www.prnewswire.com/news-releases/content-marketing-institute-acquires-intelligent-content-conference-icc-264720001.html">sold it</a></strong><a href="https://www.prnewswire.com/news-releases/content-marketing-institute-acquires-intelligent-content-conference-icc-264720001.html"> </a>to the <strong><a href="https://contentmarketinginstitute.com/">Content Marketing Institute</a></strong> in 2014. The following year, Ann, Charles Cooper, and I published <em>Intelligent Content: A Primer</em>. </p><p><strong>Chapter 1 includes Ann&#8217;s definition:</strong></p><blockquote><p>Intelligent content is designed to be modular, structured, reusable, format free, and semantically rich and, as a consequence, discoverable, reconfigurable, and adaptable.</p></blockquote><p>None of this was new in 2015. <strong><a href="https://www.linkedin.com/in/marklewisflorida/">Mark Lewis</a></strong>, author of <em><strong><a href="https://www.amazon.com/dp/B0CV6QJC72?lv=shuf&amp;channelId=500&amp;plpRedirect=mhFallback">DITA Metrics 101</a></strong></em>, opened his endorsement of the primer with that point: </p><blockquote><p>&#8220;You may be new to intelligent content, but intelligent content is not new.&#8221;</p></blockquote><p><strong>Note:</strong> Intelligent content is also known as <strong><a href="https://kineticinfo.org/council">kinetic information.</a></strong> </p><h2>What Bob Glushko Wrote In The Foreword</h2><p><strong><a href="https://www.linkedin.com/in/bobglushko/">Robert J. Glushko</a></strong>, a friend and mentor under whom I lectured at the <strong><a href="https://www.ischool.berkeley.edu/">University of California, Berkeley, School of Information</a></strong>, wrote the primer&#8217;s foreword. He described two dimensions of a digital format&#8217;s adaptability: </p><ol><li><p><strong>how far it separates semantic information</strong> (what something means) <strong>from presentation</strong> (how it looks), and </p></li><li><p><strong>how much structure and organization its semantics contain</strong></p></li></ol><p>He placed scanned print documents low on both, HTML as highly structured but usually not semantic, and XML or database content high on both, especially when it conforms to standards for a domain&#8217;s content types. He also credited Ann with persuading skeptics, back when the work involved using <strong><a href="https://www.w3.org/TR/WD-html40-970708/intro/sgmltut.html">Standard Generalized Markup Language</a></strong> (SGML), that single-source publishing was more than a cost-saving tactic.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!WNZp!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!WNZp!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 424w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 848w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 1272w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!WNZp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png" width="1456" height="485" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:485,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1523687,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/221013144?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!WNZp!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 424w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 848w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 1272w, https://substackcdn.com/image/fetch/$s_!WNZp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F590567c1-0f0e-4e1d-8a3d-09194b8094b2_2172x724.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Built For The Business Case</h2><p>Tech docs teams adopted structured content practices to solve specific business problems. Teams <strong><a href="https://www.heretto.com/capabilities/translation">concerned about translation costs</a></strong>, for example, build content reuse and conditional processing capabilities to save money on translation. Teams aiming to publish faster typically invested in workflow and output automation capabilities to increase publishing efficiency and speed time-to-market. Many of those investments met their stated goals.</p><p>Problems show up when the same content has to do a job nobody planned for, such as supplying an AI answer engine. Teams add metadata when a capability requires it. Team that published only PDFs and a help system for the past few years had no business-critical reason to tag each procedure with the product versions it covers, so its content model has no element or attribute for them.</p><h2>Valid XML, Missing Applicability</h2><p>AI answer engines may retrieve a passage from our docs without retrieving the surrounding topic content or its metadata. A hypothetical maintenance procedure illustrates the problem. </p><p>Its <strong><a href="https://www.heretto.com/blog/concept-task-reference">DITA topic</a></strong> has structured steps, a labeled warning, and metadata naming the product family. The topic validates and publishes correctly. The procedure applies only to certain versions, but the retrieved passage carries no version restriction. If the customer&#8217;s product is one of the excluded versions, the answer engine delivers instructions that don&#8217;t apply. </p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Ykge!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Ykge!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 424w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 848w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 1272w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Ykge!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png" width="1456" height="485" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:485,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1380627,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/221013144?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!Ykge!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 424w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 848w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 1272w, https://substackcdn.com/image/fetch/$s_!Ykge!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F262a3ad4-73e4-4a28-9893-6e15837e65eb_2172x724.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Either nobody recorded which versions the procedure covers, or that information got lost before it reached the answer engine. Either way, the answer engine has the steps but can&#8217;t tell whether they apply to the customer&#8217;s product.</p><p><strong><a href="https://www.xmlvalidation.com/documentation">XML validation</a></strong>, the kind of DTD check Rockley and Manning described, confirms that content conforms to its declared rules. It doesn&#8217;t establish that those rules required the facts a particular answer depends on, and it doesn&#8217;t guarantee that a retrieval pipeline preserved the relevant metadata.</p><p>I&#8217;ve been developing a method for identifying where documentation leaves important conditions or relationships implicit, including cases where the individual facts appear but their connection is unstated by the person or machine that created the docs. I&#8217;m working with academic researchers to test whether greater explicitness measurably reduces AI answer errors. A content review can identify the omissions in your docs without waiting for that research.</p><h2>Where To Look First</h2><p>Rockley and Gollner wrote that information modeling forces teams to consider all their information requirements and assess what information is available to fulfill them. For documentation that AI systems now consume, that means inspecting both the source docs and the documentation content that reaches the answer engine.</p><p>Check where your product versions, configurations, and prerequisites are recorded. Then check whether your publishing, indexing, and retrieval pipelines preserve them. Missing source information calls for changes to the content model or authoring practice. Information lost after authoring calls for changes to the processing pipeline.</p><p>Rockley and Manning&#8217;s model tracked one relationship explicitly: <strong>a derivative stayed linked to its parent, and its author learned when the parent changed.</strong> </p><p>Applicability is a different relationship, between a procedure and the products it fits, but it needs the same respect. It has to be recorded in the source and preserved to ensure access is provided to whatever systems need to read it. </p><p>The question is how much of that work our source content does, and how much it leaves the answer engine to infer. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[What Is Interoperability?]]></title><description><![CDATA[The ability of independent systems to exchange information and use it as intended, without custom conversion between them]]></description><link>https://www.thecontentwrangler.com/p/what-is-interoperability</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-interoperability</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 26 Oct 2026 12:30:35 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!MNwD!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd6086a3d-f08b-4fc5-aced-412ea77d06e0_1466x1073.png"/><content:encoded><![CDATA[<blockquote><p><strong>Interoperability (noun)</strong></p><p>The ability of independent systems to exchange information and use it as intended, without custom translation between them.</p></blockquote><h2>About Interoperability</h2><p>Suppose our organization makes automated packaging machines for food producers. We publish their documentation to an online portal and to help screens on each machine&#8217;s control panel, an AI assistant answers customer questions from the same content, and many customers schedule our recommended upkeep in their own maintenance software.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!HCD3!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!HCD3!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!HCD3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1388039,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/215411213?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!HCD3!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!HCD3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F483c1ae6-e1da-4729-8862-cb459e71b4d1_1774x887.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>The procedure for greasing a machine&#8217;s sealing-jaw bearings starts with a warning to lock out power before removing the guard. It also says to repeat the job every 500 operating hours. Our writers label the warning, each step, and the interval in a structured format. Although different companies make the portal, the control panel, the assistant, and customers&#8217; maintenance software, they understand one another because they all use the same terms to refer to (and structure for representing) warnings, steps, and intervals. The control panel shows the warning in its hazard banner, the assistant keeps the warning with the steps, and the maintenance software schedules the job every 500 hours.</p><p>Now suppose an update to the procedure formats the warning as a bold paragraph, <strong>"CAUTION!</strong> <strong>Lock out power before removing the guard,</strong>" and puts the interval in a parenthetical inside a sentence: "<strong>Grease bearings regularly (approx. every 500 hrs).</strong>" The portal page looks much as before, but the control panel finds no labeled warning and shows the text as an ordinary line. If the assistant relies on the warning label to keep warnings with their steps, it may list the greasing steps without the warning. The maintenance software finds no interval to import, so a customer has to enter it by hand or write a script to extract it.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!fI4N!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!fI4N!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!fI4N!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/af17510f-c155-4757-a76a-cdb315f5d609_1774x887.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1440078,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/215411213?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!fI4N!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!fI4N!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Faf17510f-c155-4757-a76a-cdb315f5d609_1774x887.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Why Tech Writers Need To Understand Interoperability</h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/what-is-interoperability">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Can AI Learn To Say ‘I Don’t Know’ When Documentation Doesn't Have The Answer?]]></title><description><![CDATA[Researchers are working to teach AI when to ask for more information and when to admit it doesn't know]]></description><link>https://www.thecontentwrangler.com/p/can-ai-learn-to-say-i-dont-know-when</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/can-ai-learn-to-say-i-dont-know-when</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 23 Oct 2026 13:30:33 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!pL9i!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F17cd0029-62c9-4491-8e27-232d1db0fa1a_1942x809.png"/><content:encoded><![CDATA[<p>I&#8217;ve been researching what happens when AI systems retrieve technical documentation and use it to answer customer questions. Much of that investigation concerns <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/when-ai-agents-go-beyond-the-instructions?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">explicitness</a></strong>, particularly around docs that contain the right facts but leaves the relationships between them unstated. </p><blockquote><p><strong>Example:</strong> A procedure can be technically correct while omitting conditions that experienced technicians understand and an AI system must infer.</p></blockquote><p>During my research, I came across studies asking whether language models can learn to recognize when they don&#8217;t have enough information to answer a question. Some researchers are teaching models to admit uncertainty and decline to answer rather than guess. Depending on what&#8217;s missing, a model might also ask the user for more details.</p><p>That reminded me of an argument I&#8217;ve been having with software developers for decades.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ws2C!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ws2C!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 424w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 848w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 1272w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ws2C!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png" width="1456" height="542" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:542,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1420943,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220865124?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!ws2C!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 424w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 848w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 1272w, https://substackcdn.com/image/fetch/$s_!ws2C!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc5480fb7-bc27-47c5-966f-1cc8fe21b640_2056x765.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>An Old Argument With Software Developers</h2><p>I&#8217;ve spent a big part of my career fixing tech doc issues by getting companies to use structured content like <strong><a href="https://www.heretto.com/blog/content-organization">DITA XML</a></strong>. I&#8217;ve definitely had software devs question why we even bother. A lot of them would rather write custom software to fix problems we're already solving with good content strategy and structured writing.</p><p>I understand their reasoning. Developers are accustomed to solving problems with software. When custom code appears capable of producing the desired result, changing how an organization creates and manages information can seem like an unnecessary complication.</p><p>The problem with relying on code alone is that software can assemble docs from reusable content components without determining whether those components contain the explicit information a reader must have to successfully complete a task. For example, an AI-powered search engine can find product instructions without establishing whether they apply to a particular configuration. Content standards give software systems structured information to process. Deciding which facts belong in that information and which relationships must be explicit requires knowledge of the product and how people use it.</p><p>I see a related challenge in AI development. Language models can generate plausible answers from retrieved information that is incomplete or doesn&#8217;t establish which instructions apply, and researchers are investigating how to make models recognize when they lack the evidence to answer reliably.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ulyS!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ulyS!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 424w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 848w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 1272w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!ulyS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png" width="1456" height="638" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:638,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1413332,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220865124?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!ulyS!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 424w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 848w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 1272w, https://substackcdn.com/image/fetch/$s_!ulyS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0c9261ce-08a4-4dae-b6f7-f50b8e6a386f_1895x830.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Why AI Systems Are Rewarded For Guessing</h2><p>AI systems are rewarded for guessing because most of the tests used to grade them give them no credit for saying &#8220;I don&#8217;t know.&#8221; A guess <em>might</em> earn points. Admitting uncertainty doesn&#8217;t. </p><p>It works like a multiple-choice classroom exam that gives no credit for blank answers.</p><p>Of course, AI models aren&#8217;t human and doesn&#8217;t care about scores, but the people who build them do. Devs use scores to decide which versions of a model to release, and many training methods adjust a model toward the kinds of answers that score well. Repeated over many rounds of training and selection, guessing becomes the default behavior.</p><p>That&#8217;s the argument researchers from OpenAI and Georgia Tech made in a <strong><a href="https://www.nature.com/articles/s41586-026-10549-w">2026 paper in </a></strong><em><strong><a href="https://www.nature.com/articles/s41586-026-10549-w">Nature</a></strong></em>. They propose scoring that penalizes wrong answers and gives credit for admitting uncertainty, while rewarding correct answers so models aren&#8217;t encouraged to refuse questions they can answer.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!8uXG!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!8uXG!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!8uXG!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1453661,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220865124?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!8uXG!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!8uXG!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F30fe6934-d2d4-450d-b05c-acc714890e1a_1774x887.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What The Model Learns Vs. What It&#8217;s Given</h2><p>AI systems can fail to know something in two different ways. The first involves what the model learned during training. </p><p>A <strong><a href="https://arxiv.org/abs/2406.10881">2024 study</a></strong> tested a method called <strong><a href="https://arxiv.org/html/1911.02168v2">Contextualized Knowledge Graph Embedding</a> </strong>(CoKE) that teaches a model to recognize when it&#8217;s unsure, based on how confident it is in its own predictions. In the researchers&#8217; tests, models trained this way got better at answering questions they knew and declining questions they didn&#8217;t.</p><p>The second way AI systems can fail to know something involves what the model is given when someone asks a question. </p><p>AI assistants that answer product information questions from tech docs don&#8217;t rely on training alone. They retrieve documentation content and pass it to the model along with the user&#8217;s question. A model can know a lot about industrial sensors in general and still need the product docs to answer questions about a specific model or configuration, including details it never saw in training.</p><p>That second kind most directly affects tech writers. The question for us is whether the retrieved docs contain sufficient information to answer what the user asked.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Ijvo!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Ijvo!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Ijvo!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/b0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1348688,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220865124?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Ijvo!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 424w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 848w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 1272w, https://substackcdn.com/image/fetch/$s_!Ijvo!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb0d2534a-9210-4fba-834e-2e4d28877852_1774x887.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Measuring Whether AI Knows When To Stop</h2><p>Researchers are building tests to check whether a model says "I don't know" when it should, without refusing to provide trustworthy answers to questions it could answer. </p><p>One approach tests models with deliberately unanswerable questions, including questions based on false assumptions or missing information. <strong><a href="https://arxiv.org/abs/2506.09038">AbstentionBench</a></strong>, published in June 2025, evaluated 20 frontier models across 20 datasets. Even the largest models struggled to tell when they should say &#8220;I don&#8217;t know.&#8221; And in the researchers&#8217; tests, models given extra training to reason through problems step by step were, on average, 24% worse at recognizing when they shouldn&#8217;t answer.</p><p>Other approaches examine internal prediction probabilities, compare responses to repeated questions, or use another language model to judge whether an answer is supported by the supplied evidence. Each method has limitations. A model can confidently produce an incorrect answer, repeat the same error consistently, or be evaluated incorrectly by an automated judge.</p><p>These evaluations examine model behavior. Documentation teams also need to determine whether the retrieval system supplied enough information for the model to answer.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wa0E!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wa0E!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!wa0E!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png" width="1456" height="607" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:607,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1643895,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220865124?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!wa0E!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!wa0E!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F86b7f062-1e2c-423a-b1d4-2f5b17f61f26_1942x809.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>When Retrieved Documentation Is Incomplete</h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/can-ai-learn-to-say-i-dont-know-when">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[The Standard That Connects AI To Your Content Now Forgets On Purpose]]></title><description><![CDATA[A major revision to the Model Context Protocol changes how AI apps exchange context with content and tools they connect to, and what tech docs teams need to explain]]></description><link>https://www.thecontentwrangler.com/p/the-standard-that-connects-ai-to</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-standard-that-connects-ai-to</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 22 Oct 2026 13:31:38 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!tYbW!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6a247132-bfce-42d6-bd6d-bbccf6db2cac_1774x887.png"/><content:encoded><![CDATA[<p>On July 28, 2026, the maintainers of the <strong><a href="https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro">Model Context Protocol</a></strong> (MCP) released a new <strong><a href="https://modelcontextprotocol.io/specification/2026-07-28/changelog">specification</a></strong>. MCP lets AI assistants and autonomous agents connect to external content and tools, such as your documentation portal or your support ticketing system. The maintainers describe it as MCP&#8217;s largest revision since its launch.</p><p>The main change is that the protocol no longer keeps track of ongoing exchanges between AI apps and the other systems it connects to. Each message now carries the info needed to handle it on its own. Engineers call this a <strong><a href="https://www.redhat.com/en/topics/cloud-native-apps/stateful-vs-stateless">stateless design</a></strong>. </p><p>The change affects how developers run MCP servers and how documentation teams explain those integrations. It also mirrors a decision anyone who writes reusable help topics makes every day: <strong>what to include so a piece of content works without relying on the content contained on the pages around it.</strong></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/the-standard-that-connects-ai-to">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Can S1000D Eliminate AI Hallucinations?]]></title><description><![CDATA[Complying with an XML specification doesn&#8217;t make AI hallucinations go away, no matter how rigorous the specification is]]></description><link>https://www.thecontentwrangler.com/p/can-s1000d-eliminate-ai-hallucinations</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/can-s1000d-eliminate-ai-hallucinations</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 21 Oct 2026 12:31:44 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!x3T2!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png"/><content:encoded><![CDATA[<p>A colleague recently asked for my feedback on a presentation idea: a draft paper advocating the adoption of <strong><a href="https://s1000d.org">S1000D</a></strong> in the nuclear energy industry.</p><p>I agreed with much of it. S1000D helps organizations manage and exchange reusable technical information, and it records which equipment configurations each instruction applies to. Those capabilities are valuable where an incorrect maintenance instruction could put people at risk.</p><p>One claim went further. The author credited S1000D with providing a machine-readable foundation for AI platforms, &#8220;eliminating information blind spots and model hallucination risks.&#8221;</p><p><em>Eliminating</em> is the word I object to. That&#8217;s not a defensible claim. I&#8217;ve advocated for structured content, including DITA XML and component content management systems, for much of my career, and I share the author&#8217;s preference for structured information over the standalone word processor files the paper describes.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!x3T2!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!x3T2!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!x3T2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png" width="1456" height="607" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:607,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1596168,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220761611?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!x3T2!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!x3T2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc7e6a294-7005-405b-8eb9-3dae5e132b4b_1942x809.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>One Aircraft, Many Configurations</h2><p>S1000D began in European aerospace and defense in the 1980s. It organizes technical information into data modules, identified by codes and managed in a <strong><a href="https://www.oneil.com/mastering-s1000d-understanding-and-implementing-the-common-source-database-csdb/">Common Source Database</a></strong> (CSDB). The modules can be maintained independently and used in publications for different products or configurations.</p><p>An aircraft manufacturer, for example, may need one procedure for a particular equipment configuration and another for a different one. S1000D provides a way to identify where each procedure applies. An AI system could use that information to help select the appropriate instructions, provided its retrieval process has access to it and applies it correctly.</p><h2>What a Schema Checks</h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/can-s1000d-eliminate-ai-hallucinations">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Beyond AI-Assisted Writing: How Agentic AI Can Transform Content Operations]]></title><description><![CDATA[Technical communication, product content, and customer success teams can put AI agents to work&#8211;and prepare the knowledge and workflows they need to succeed]]></description><link>https://www.thecontentwrangler.com/p/beyond-ai-assisted-writing-how-agentic</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/beyond-ai-assisted-writing-how-agentic</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 20 Oct 2026 12:31:35 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!aCTu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png"/><content:encoded><![CDATA[<p>by <strong><a href="https://www.linkedin.com/in/leenjones/">Colleen Jones</a></strong>, <strong><a href="https://content-science.com/">Content Science</a></strong></p><p>Imagine an AI agent that can investigate why customers keep asking the same question, find the relevant product documentation, compare it with known issues, identify gaps in the explanation, and recommend what your team should fix first.</p><p>Now imagine that agent can do more than make recommendations. It can prepare an updated knowledge article, check it against your terminology and style standards, route it for review, and help measure whether the change reduces customer confusion. That is a much different proposition from asking AI to draft a paragraph.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!aCTu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!aCTu!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 424w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 848w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 1272w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!aCTu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png" width="1484" height="568" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:568,&quot;width&quot;:1484,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1031585,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5155f0bf-517e-4ccb-bd44-8b4ef1fbb3ec_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!aCTu!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 424w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 848w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 1272w, https://substackcdn.com/image/fetch/$s_!aCTu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3bb78f08-caac-4847-ac5d-18d94897a6ee_1484x568.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><strong>It also raises a different set of questions:</strong></p><ul><li><p>What knowledge does the agent need? </p></li><li><p>How will it know what good looks like? </p></li><li><p>Which tasks can it perform independently? </p></li><li><p>Where should a person review its work? </p></li><li><p>And how will your organization know whether the effort improves the customer experience?</p></li></ul><p>These are the questions forward-thinking technical communication, product content, customer support, and customer success leaders will ask as agentic AI evolves.</p><p>In my recent article, <strong><a href="https://review.content-science.com/are-ai-agents-failures-or-the-future/">Are AI Agents Useless Failures or the Key to AI&#8217;s Future?</a></strong>, I explored why the promise of agents depends on applying them to useful organizational work, making them easier to manage, and connecting them to the right knowledge.</p><p>For content teams, those principles have particularly important implications. Agents could change not only how content gets created, but also how teams maintain product knowledge, resolve customer issues, coordinate work, and improve experiences over time.</p><p>The real opportunity here is not to create more content with fewer people. It&#8217;s to make organizational expertise more accessible and actionable. Let&#8217;s consider <strong>five ways</strong> to act on this opportunity.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>1. Start With the Work Customers and Teams Need Done</h2><p>The first question about agentic AI shouldn&#8217;t be, </p><blockquote><p><strong>&#8220;What can this agent do?&#8221;</strong> </p></blockquote><p>It should be, </p><blockquote><p><strong>&#8220;What work needs to get done, and why is it difficult today?&#8221;</strong></p></blockquote><p>Or, use this eye-opening variation that <strong><a href="https://www.linkedin.com/in/laurarbarnes/">Laura Barnes</a></strong>, senior director at <strong><a href="https://www.redhat.com/en">Red Hat</a></strong>, shared with me on my podcast <strong><a href="https://content-science.com/publications/cs-contentpowersai/">Content Powers AI</a></strong>,</p><blockquote><p><strong>&#8220;What do you not want to do anymore? What do you think is a waste of your time?&#8221;</strong></p></blockquote><p>Consider the work surrounding a seemingly straightforward support question. A customer encounters an error. A support specialist searches documentation, checks a troubleshooting guide, consults an internal knowledge base, reviews known issues, and perhaps asks a product expert for help. If the documentation is incomplete or outdated, the specialist may need to piece together an answer from several sources.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!159D!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!159D!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!159D!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!159D!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!159D!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!159D!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1470696,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!159D!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!159D!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!159D!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!159D!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5383f3bd-0e7a-4bba-8d5f-87aeb993c7e5_1484x1060.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Meanwhile, the documentation team may not know that the same question has consumed hours of support time across hundreds of cases.</p><p>The underlying work crosses functions, systems, and content types. It may require research, analysis, coordination, and judgment&#8212;not just writing.</p><p>Agentic AI can be useful when it takes on portions of this interconnected work. <strong>For example, an agent might:</strong></p><ul><li><p>Analyze support cases to identify recurring questions and emerging issues.</p></li><li><p>Locate relevant product documentation, release notes, and internal knowledge.</p></li><li><p>Compare customer questions with existing answers to identify content gaps.</p></li><li><p>Assemble evidence and recommendations for a technical writer or product expert.</p></li><li><p>Prepare a content update and route it through the appropriate review process.</p></li><li><p>Help connect changes in documentation with subsequent support outcomes.</p></li></ul><p>These are potential applications, not capabilities every agent automatically possesses. They depend on the agent&#8217;s tools, access, instructions, and the quality of the organization&#8217;s underlying information.</p><p>The important shift is to begin with a real workflow and identify where an agent can make a meaningful contribution.</p><p>For content and support leaders, this means looking beyond isolated writing tasks. Examine the work that happens before and after content is published: finding information, validating it, maintaining it, responding to feedback, and coordinating changes across teams. That is where larger opportunities lie.</p><h2>2. Design the Workflow, Not Just the Agent</h2><p>An agent can be impressive in a demonstration and still struggle to deliver value in daily work. That&#8217;s because organizations don&#8217;t operate through isolated prompts. They operate through workflows, responsibilities, systems, and decisions.</p><p>A technical writer might need to know whether a product feature has shipped before updating its documentation. A support specialist might need to distinguish between a verified solution and a workaround that applies only to certain configurations. A customer success manager might need to coordinate guidance across product versions, customer environments, and account-specific requirements.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!J4qe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!J4qe!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 424w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 848w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 1272w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!J4qe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png" width="1659" height="650" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:650,&quot;width&quot;:1659,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1349411,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffa9a031f-53c6-479d-8543-e02f2dc53d9c_1659x948.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!J4qe!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 424w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 848w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 1272w, https://substackcdn.com/image/fetch/$s_!J4qe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F38d02252-08c9-4e9f-a055-3f743dd58367_1659x650.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>An agent that ignores these realities can produce plausible work that is nevertheless wrong, premature, or unusable. Chuck Gahun, a principal analyst at Forrester, and I recently discussed this on Content Powers AI. He noted,</p><blockquote><p><strong>&#8220;The ones that are being successful &#8230; are the ones that are thinking through their content ops processes fundamentally differently in the age of agents. That&#8217;s where the value comes for an organization.&#8221;</strong></p></blockquote><p>Making agentic AI useful requires rethinking how work moves through the organization. It starts by mapping the workflow you want to improve. Identify the information needed at each step, the decisions people make, the systems involved, and the conditions under which work can move forward.</p><p>When you really get into this thinking, you realize agents can do very useful things&#8212;such as run multiple analyses in parallel, synthesize results, and draft insights&#8212;that humans simply cannot do. And that can unlock new possibilities.</p><p>For instance, even though our research into content operations for the past decade shows measuring content effectiveness or impact is a top success factor, 50% of organizations don&#8217;t do it. They report not having the time, training, tools, or resources. Agentic AI can close this gap.</p><p>As you consider the possibilities, further determine which activities an agent can perform, which decisions require human judgment, and which actions need explicit approval.</p><p>For instance, an agent might be allowed to identify outdated documentation and prepare a proposed revision. It might also check the draft against product terminology, accessibility requirements, and approved sources. But publishing a change that affects a critical workflow could require review by a product specialist or designated content owner.</p><div class="callout-block" data-callout="true"><h4>This isn&#8217;t about adding approval steps everywhere. It&#8217;s about placing controls where errors could meaningfully affect customers, employees, or the business.</h4></div><p>It also means designing for exceptions. What happens when sources disagree? What if the product version is unclear? What if the agent cannot verify an answer?</p><p>A useful agent needs a way to recognize when it lacks sufficient information and escalate rather than confidently improvise.</p><p>The goal is not to automate an existing workflow exactly as it is. It&#8217;s to determine whether the workflow itself should change&#8212;and then decide where agentic AI can make that new workflow more effective.</p><h2>3. Give Agents the Knowledge and Context They Need</h2><p>Here&#8217;s a challenge that content professionals understand particularly well: Having information available is not the same as having information that is useful and actionable.</p><p>An organization may have extensive product documentation, troubleshooting guides, knowledge articles, release notes, and internal expertise. Yet customers and employees can still struggle to find the right answer.</p><p>Information may be scattered across repositories. Terminology may vary between product teams. Instructions may contradict one another. An article may be accurate for one product version but wrong for another. Important knowledge may exist only in the experience of a few specialists.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Oh6W!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Oh6W!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Oh6W!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png" width="1456" height="607" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:607,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1475317,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Oh6W!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 424w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 848w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 1272w, https://substackcdn.com/image/fetch/$s_!Oh6W!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a06797e-33e0-4b1b-b73b-3bbf060c9b53_1942x809.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>These issues become especially consequential when AI agents begin using organizational information to recommend answers or take action.</p><p>A human expert can sometimes recognize that a document is outdated, infer what an ambiguous instruction means, or ask a colleague for clarification. An agent may not have the context needed to make those distinctions reliably.</p><p>That makes the content environment a critical part of agentic AI. For technical communication and product content teams, preparing that environment may involve:</p><ul><li><p><strong>Establishing trustworthy sources.</strong> Identify authoritative content and clarify which sources take precedence when information conflicts.</p></li><li><p><strong>Improving structure and relationships.</strong> Make products, features, tasks, concepts, versions, and related information easier to distinguish and connect.</p></li><li><p><strong>Maintaining accuracy over time.</strong> Connect content updates to product releases, policy changes, known issues, and other events that affect its validity.</p></li><li><p><strong>Clarifying ownership.</strong> Establish who is responsible for approving, maintaining, and retiring different types of knowledge.</p></li><li><p><strong>Providing meaningful context.</strong> Make clear who an instruction is for, when it applies, what prerequisites it assumes, and what limitations matter.</p></li><li><p><strong>Making expertise accessible.</strong> Capture the reasoning, standards, and specialized knowledge that help experienced people make good decisions.</p></li></ul><p>Not every organization can restructure all of its content before experimenting with agents. If you&#8217;re in that situation, you can start with the knowledge required for a specific workflow. Assess its quality, accessibility, structure, and governance. Address the gaps that are likely to affect the agent&#8217;s performance, then expand based on what you learn.</p><p>The broader lesson is that content quality for agentic AI involves more than well-written sentences. It includes the reliability, relationships, context, and governance of the knowledge those sentences convey.</p><h2>4. Make Human Expertise More Valuable, Not Less</h2><p>If people no longer have to do the content work they don&#8217;t like or that is a waste of their time, an interesting question arises. What can people can do with the capacity that becomes available?</p><p>Technical communicators bring more than writing skills. They understand how people use products, where instructions break down, how terminology affects comprehension, and how to translate complex systems into useful guidance.</p><p>Customer success professionals understand customer goals, adoption barriers, organizational context, and the factors that help customers realize value.</p><p>These capabilities represent different forms of expertise that can improve the decisions an AI system supports.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!x4Sa!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!x4Sa!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!x4Sa!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1467270,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!x4Sa!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!x4Sa!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F300ca2ef-ffdc-4dfb-a8b0-61f4742eafaa_1536x1024.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Imagine an agent that analyzes thousands of support cases and identifies a pattern. The pattern itself is only the beginning. A technical communicator might determine that a confusing prerequisite is missing from the documentation. A product specialist might discover that a recent interface change has made an instruction inaccurate. A customer success leader might recognize that customers misunderstand the larger process, not just one feature.</p><p>AI can help surface the evidence. People bring the contextual understanding needed to interpret it, decide what matters, and determine what should change.</p><p>That division of work will vary by organization and use case. Some tasks may eventually be handled with little intervention; others will continue to require substantial human involvement. The objective should be to use human expertise where it has the greatest impact.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!U7k6!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!U7k6!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 424w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 848w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 1272w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!U7k6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png" width="1536" height="991" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:991,&quot;width&quot;:1536,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2007645,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F80a5801c-10ec-441d-bc26-5e66acb05777_1536x1024.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!U7k6!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 424w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 848w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 1272w, https://substackcdn.com/image/fetch/$s_!U7k6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc03d2585-d4de-44d4-a268-ed939b3e789e_1536x991.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>5. Measure Whether the Work Gets Better</h2><p>It&#8217;s easy to measure an agent&#8217;s activity. It may process articles, execute analyses, generate recommendations, or complete a sequence of steps. But activity isn&#8217;t the same as value.</p><p>For content, support, and customer success teams, the more meaningful question is whether agentic AI improves the work and the experiences that depend on it.</p><p><strong>The right measures will vary by workflow, but could include:</strong></p><ul><li><p><strong>Resolution effectiveness:</strong> Are customers and support specialists finding accurate answers and resolving issues more successfully?</p></li><li><p><strong>Content quality:</strong> Are instructions still clear, complete, and accurate for the relevant product or customer situation?</p></li><li><p><strong>Time to useful information:</strong> Can employees and customers find the knowledge they need more quickly?</p></li><li><p><strong>Maintenance efficiency:</strong> Can teams identify and address outdated, duplicated, or missing content with less effort?</p></li><li><p><strong>Customer experience:</strong> Are recurring sources of confusion declining? Are customers better able to complete tasks or adopt product capabilities?</p></li><li><p><strong>Operational capacity:</strong> Are content and support professionals spending less time on repetitive work and more time on analysis, problem-solving, and improvements?</p></li><li><p><strong>Risk and reliability:</strong> How often does the agent produce unsupported recommendations, encounter exceptions, or require human intervention?</p></li></ul><p>These measures should be tied to a clear baseline wherever possible. If the goal is to reduce repetitive support work, for example, measure the current effort and outcomes before introducing an agent. Then evaluate what changes, including any new review or maintenance work the system creates.</p><p>It&#8217;s also important to measure the right level of the system. A faster content-production process may be useful, but if it generates more material that customers cannot find or understand, the overall experience may not improve.</p><p>This is why content effectiveness matters. The value of an agent isn&#8217;t determined solely by how much work it performs. It&#8217;s determined by what that work enables.</p><h2>Where Should Content Teams Start?</h2><p>Getting started with agentic AI doesn&#8217;t necessarily mean building a custom agent from scratch. It means preparing your team, choosing the right tools, and testing where agents can make a meaningful difference.</p><p><strong>1. Build your team&#8217;s understanding.</strong> Train content, product, and support professionals to understand how agentic AI works, where it can add value, what its limitations are, and how to evaluate its outputs. Involve the people closest to the work in identifying promising opportunities.</p><p><strong>2. Decide whether to build or buy.</strong> Explore whether agentic capabilities already available in your existing content, knowledge, support, and workflow tools. Consider new tools or custom agents when existing capabilities don&#8217;t meet your needs, or when your use case requires specialized knowledge, integrations, or control.</p><p><strong>3. Plan a focused pilot.</strong> Choose one manageable use case with a clear business or customer benefit. Define what the agent will do, what information and permissions it needs, where human review is required, and how you&#8217;ll measure success. Test it against real scenarios, learn from the results, and refine your approach before expanding.</p><p>The goal is to build the skills and experience to determine where agentic AI can improve the work and how to make those improvements stick.</p><h2>The Future Of Content Is Bigger Than Production</h2><p>AI agents could become valuable collaborators for technical communication, product content, support, and customer success teams. They may help organizations connect information, analyze patterns, coordinate work, and turn knowledge into action at a scale that would otherwise be very difficult to achieve.</p><p>But those outcomes won&#8217;t come from agent capabilities alone. They depend on understanding the work, designing effective workflows, providing reliable knowledge, establishing appropriate governance, and preserving the human expertise needed to make good decisions.</p><p>For content professionals, that creates an opportunity to expand their influence.<strong> Your role can extend beyond creating and maintaining individual deliverables to shaping the knowledge, standards, and systems that guide AI-powered work. That is a significant shift, and it makes your discipline exponentially more valuable. &#129312;</strong></p><div><hr></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!3aFs!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!3aFs!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 424w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 848w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 1272w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!3aFs!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png" width="1456" height="526" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:526,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2121923,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/220585997?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!3aFs!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 424w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 848w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 1272w, https://substackcdn.com/image/fetch/$s_!3aFs!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff3e2d5ec-5aab-4e37-acb0-f081cac331e9_1938x700.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><strong><a href="https://www.linkedin.com/in/leenjones/">Colleen Jones</a></strong> is the president of <strong><a href="http://content-science.com/">Content Science</a></strong> and a recognized expert on content, AI, and digital transformation, advising top organizations around the world such as Dell, Thompson Reuters, and The Home Depot. The author of the top-rated book <strong><a href="https://www.amazon.com/dp/B0DGN1TYYB?lv=shuf&amp;channelId=500&amp;plpRedirect=mhFallback">The Content Advantage</a> </strong>(third edition out now), Colleen hosts conversations with senior leaders on the <strong>Content Powers AI</strong> podcast.</p><p>A passionate entrepreneur, Colleen has led Content Science to conduct the world&#8217;s largest ongoing <strong><a href="https://content-science.com/content-operations-study/">study of content operations and AI</a></strong>, develop the patented <strong><a href="https://content-science.com/contentwrx/">ContentWRX</a></strong> evaluation system, and architect of the AI superagent <strong><a href="https://content-science.com/products/">ContentIQ</a></strong>.</p><p>She served as head of content at Mailchimp during its transformation into a marketing platform and eventual $12 billion acquisition by Intuit. Colleen also led customer experience transformation at AT&amp;T and the Center for Disease Control. Sharing insights based on her experience and her firm&#8217;s research, she is a frequent contributor to business and technology publications and podcasts as well as a top <strong><a href="https://www.linkedin.com/learning/introduction-to-content-marketing-2/win-customers-with-content-marketing">LinkedIn Learning</a></strong> instructor. Follow Colleen on <strong><a href="https://www.linkedin.com/in/leenjones/">LinkedIn</a></strong>.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[What Is Maintainability?]]></title><description><![CDATA[What separates documentation you can keep current from documentation you can only hope you've updated everywhere]]></description><link>https://www.thecontentwrangler.com/p/what-is-maintainability</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-maintainability</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 19 Oct 2026 12:30:40 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!bMX9!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Feb1af675-0c30-4920-a765-bce2c1d8241e_1466x1073.png"/><content:encoded><![CDATA[<blockquote><p><strong>Maintainability (noun)</strong></p><p>The degree to which something can be kept correct and current, with reasonable effort and risk, as its subject changes.</p></blockquote><h2>About Maintainability</h2><p>Suppose our organization makes cloud accounting software. We publish our docs to a web portal and to in-product help, and an AI assistant answers customer questions from the same content.</p><p>One of our procedures explains how to <em>export invoices</em>. In an upcoming release, the product team decides to move the <strong>Export</strong> button from the <strong>Billing</strong> page to the <strong>Reports</strong> page. If our documentation is designed to be maintainable, that change takes one quick edit. </p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!jZpx!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!jZpx!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 424w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 848w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 1272w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!jZpx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png" width="1484" height="963" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:963,&quot;width&quot;:1484,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1729696,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219154223?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1721049f-06c0-4f26-83d5-4aa6489c1848_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!jZpx!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 424w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 848w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 1272w, https://substackcdn.com/image/fetch/$s_!jZpx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2f17a6d5-4c1e-44f9-8665-36b8a95dc7ed_1484x963.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Our procedures are <strong><a href="https://www.heretto.com/blog/single-source-publishing">single-sourced</a></strong>, which allows us to <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/what-is-composability">reuse</a></strong> them systematically in every channel we support instead of copying and pasting them into multiple files. We store reusable piece of content in our <strong><a href="https://www.heretto.com/platform/ccms">component content management system</a></strong> (CCMS), where we also tag them with metadata identifying the part of the product they describe, so before the release ships, our writers can efficiently locate every topic tagged for invoice exports without relying on memory.</p><p>Imagine a writer previously created a troubleshooting article but typed out the instructions manually instead of linking to the central, reusable version. Because they didn't tag the article, writers might not find it when searching for content to update before a new release. In this scenario, once the update goes live, the website will contain two different answers to the same question and only one of them will be correct.</p><h2>Why Tech Writers Must Understand Maintainability</h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/what-is-maintainability">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Alternatives To Evidence-Based Technical Documentation]]></title><description><![CDATA[Three methods every documentation team uses and that no style guide addresses]]></description><link>https://www.thecontentwrangler.com/p/alternatives-to-evidence-based-technical</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/alternatives-to-evidence-based-technical</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 15 Oct 2026 12:30:47 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!u3sq!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png"/><content:encoded><![CDATA[<p>A recent <strong><a href="https://marketoonist.com/2026/09/gut-feel-decision-making.html">Marketoon</a></strong> post by <strong><a href="https://marketoonist.com/about">Tom Fishburne</a></strong> takes on &#8220;eminence-based marketing,&#8221; and in addition to making me giggle, it also made me think tech docs has its own version. The phrase Fishburne discusses comes from medicine. In 1999, two physicians published a tongue-in-cheek <strong><a href="https://www.bmj.com/content/319/7225/1618">British Medical Journal paper</a></strong><a href="https://www.bmj.com/content/319/7225/1618"> </a>listing seven alternatives to evidence-based medicine. Three of them describe technical documentation types uncomfortably well.</p><div class="pullquote"><p><strong>&#129315; What follows is satire.</strong> To show how these methods work in practice, I invented a software company and gave it a documentation team. The company and everyone in it are fictional. <strong>Any resemblance to your team is purely coincidental.</strong></p></div><h2>Eminence-Based Documentation</h2><p>At our fictional software company, a new tech writer, Becky, asks if anyone can tell her how to find out if an installation procedure is correct. </p><p>The room goes quiet. Eventually, the senior writer says, </p><blockquote><p>&#8220;Martin wrote it.&#8221; </p></blockquote><p>She asks who Martin is. </p><blockquote><p>&#8220;Martin left in 2017.&#8221; </p></blockquote><p>The interface has been redesigned three times since then, and the procedure still tells users to click <strong>Advanced Settings</strong>, a button that hasn&#8217;t existed for years. After a long pause, someone suggests users should probably submit a support ticket.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Il6H!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Il6H!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Il6H!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1775708,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219645123?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Il6H!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!Il6H!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1de0599f-9e76-4784-82cb-c421341c1fba_1484x1060.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Becky soon learns what her department&#8217;s standards of evidence are:</p><ul><li><p>If a developer said it, it&#8217;s probably true.</p></li><li><p>If a senior developer said it, don&#8217;t question it.</p></li><li><p>If a step appears in more than one manual, that counts as peer review.</p></li><li><p>If Martin wrote it, it&#8217;s a requirement.</p></li><li><p>If nobody knows why something is documented, it&#8217;s called institutional knowledge.</p></li></ul><p>Then Becky finds a 14-year-old comment in the source: <code>&lt;!-- DO NOT REMOVE THIS STEP. &#8212; MARTIN --&gt;</code>. Nobody knows what the step does or which Martin wrote it. There have, it turns out, been three Martins in that time. The team agrees not to touch it, which is how a workaround for version 4.2 became company policy in version 11.</p><div class="callout-block" data-callout="true"><h3>Evidence-based documentation asks what the product does. Eminence-based documentation asks who you are to question Martin.</h3></div><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>Vehemence-Based Documentation</h2><p>At our fictional company, vehemence lives in review comments, where the correct wording is whatever someone defends in capital letters. A reviewer signals mounting certainty with a second exclamation point, then with &#8220;as I mentioned previously,&#8221; and finally by scheduling a meeting. The Oxford comma debate reached that last stage two years ago. It&#8217;s now a standing meeting with no decision in sight.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!u3sq!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!u3sq!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!u3sq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1753717,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219645123?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!u3sq!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!u3sq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F00cfd3dc-faf0-4711-83d6-43e6c035aa30_1484x1060.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>The style guide reserves <strong><span data-color="#ff0000" style="color: rgb(255, 0, 0);">Danger</span></strong> for situations that could cause serious harm. Vehemence-based documentation reserves it for the reviewer who replied in ALL CAPS. </p><p>That&#8217;s how a mildly inconvenient default setting ends up with a bold red <strong><span data-color="#ff0000" style="color: rgb(255, 0, 0);">Danger</span></strong> label while the step that deletes the user&#8217;s data gets nothing, because nobody argued about it.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!2rFb!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!2rFb!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!2rFb!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1923434,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219645123?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!2rFb!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!2rFb!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3998b138-84e2-4915-a23a-656c3eff761f_1484x1060.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-tqxFUX" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-tqxFUX" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Confidence-Based Documentation</h2><p>At our fictional company, confidence-based documentation is restricted to the engineer who built the feature, much as the BMJ paper restricted confidence-based medicine to surgeons. &#8220;It&#8217;s intuitive,&#8221; the engineer says. &#8220;Nobody will need docs.&#8221;</p><p>When docs get written anyway, the confidence shows up in the adverbs. </p><blockquote><p>&#8220;Simply configure your identity provider&#8221; </p></blockquote><p>introduces a task that takes two days and a ticket to IT. </p><blockquote><p>&#8220;Easily migrate your data&#8221; </p></blockquote><p>is followed by 47 steps, three of them in a terminal. </p><p>The estimated-time label at the top of the page promises it will take about five minutes. The fastest recorded time, set by the engineer who built the feature, is four hours.</p><p>Release notes are confidence-based documentation in its purest form: </p><blockquote><p>&#8220;Various improvements and bug fixes.&#8221; </p></blockquote><p>Which improvements? The confidence speaks for itself. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[Why Organizations Invest in a CCMS?]]></title><description><![CDATA[How a component content management system helps documentation teams reuse shared instructions across products and languages, and what makes those savings worth funding]]></description><link>https://www.thecontentwrangler.com/p/why-organizations-invest-in-a-ccms</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/why-organizations-invest-in-a-ccms</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 14 Oct 2026 12:30:51 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!oKpl!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png"/><content:encoded><![CDATA[<p>Suppose your company makes a family of five countertop stand kitchen mixers: three tilt-head models and two bowl-lift models (one with a timer). Four are for home cooks and bakers and one is for professionals.</p><p>Each kitchen mixer model needs its own manual, but much of the text overlaps. For instance, the exterior cleaning instructions are exactly the same across all five machines.<br><br>Because the team maintains separate manuals for each model, those cleaning instructions are duplicated five times. And that&#8217;s just the English language versions. The docs are written in English and translated into four other languages. If the cleaning steps change, writers must update all five English copies and send each one out for translation again. That means republishing 25 documents for a single edit. If they miss just one, some customers end up with outdated information.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!oKpl!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!oKpl!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!oKpl!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/cfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1536979,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!oKpl!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!oKpl!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfb8e0d1-7de0-481b-a83a-8d2120689c7e_1484x1060.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>A <strong><a href="https://www.heretto.com/blog/component-content-management-system">component content management system</a></strong> (CCMS) fixes this by replacing those duplicates with a single shared file. The docs team writes the instructions once, and every manual links to it.</p><p>If the text changes, writers make updates to that central source file. The system knows which manuals use it, making it easy to update and republish them all at once.</p><p>The improvements are easy to describe. Getting them funded is harder, because the cost it reduces doesn&#8217;t appear anywhere on the mixer company&#8217;s financials. </p><p>Leadership likely sees that the docs were delivered on time. But they seldom see the wasted hours or the frustratingly tedious workarounds required to keep 25 separate documents perfectly synced without someone pointing these things out.</p><div class="callout-block" data-callout="true"><h3>To get funding for a CCMS, a documentation leader has to expose hidden costs and show the company leadership what it stands to gain by eliminating them.</h3></div><h2>What Does A CCMS Manage?</h2><p>A CCMS manages content in pieces that can be maintained and reused on their own, such as a procedure or a safety warning. These pieces are called components. A publication, such as a printed manual or a support website, is assembled from the components its readers need, in the order they need them.</p><p>Here is how the mixer company&#8217;s content could be divided. Assume the manufacturer has verified where each set of instructions applies.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!AXml!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!AXml!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 424w, https://substackcdn.com/image/fetch/$s_!AXml!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 848w, https://substackcdn.com/image/fetch/$s_!AXml!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 1272w, https://substackcdn.com/image/fetch/$s_!AXml!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!AXml!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:92856,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!AXml!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 424w, https://substackcdn.com/image/fetch/$s_!AXml!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 848w, https://substackcdn.com/image/fetch/$s_!AXml!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 1272w, https://substackcdn.com/image/fetch/$s_!AXml!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F65257dea-072d-4f7e-83a5-7b4318cd8e4a_1600x800.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption">Each product manual is published in English and four other languages. The shared cleaning procedure therefore appears in 25 published documents. The timer instructions appear in five, all for the single model with a timer.</figcaption></figure></div><p>Each manual combines the components its model requires. Writers reuse an entire procedure or, where it makes sense, a smaller component inside one, such as a single warning. Reuse in a CCMS works through references. A pasted copy becomes one more text that someone has to maintain, while reusing content by reference keeps every manual tied to the same managed source. The CCMS serves as the single source of truth, recording where each component is used and keeping its version history, so a writer can see what a change will affect before making it. </p><p>Ann Rockley describes this approach to linked reuse in <em><strong><a href="https://www.peachpit.com/store/managing-enterprise-content-a-unified-content-strategy-9780735713062">Managing Enterprise Content: A Unified Content Strategy</a></strong></em>.</p><p>Editing a component does not publish anything by itself. The team decides which revision belongs in each manual and releases it through its approved review and publishing workflow.</p><h2>Where Do Structured Content And DITA Fit?</h2><p>Reuse works best when the cleaning instructions have an internal organization that software can recognize. A procedure might identify any preparation required, followed by numbered steps. Structured authoring gives writers defined places for those kinds of information and rules for how they fit together. Separate publishing rules decide how the content looks in a printed manual or on a support website, so writers don&#8217;t format each output by hand.</p><p>A word-processing document can look well organized without telling software which part is a step and which part is a warning. Structured content makes those distinctions explicit. Moving to it also requires the team to decide how to divide its information into components that still make sense to readers.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Kwg8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Kwg8!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!Kwg8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1544233,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Kwg8!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 424w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 848w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 1272w, https://substackcdn.com/image/fetch/$s_!Kwg8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd28bbc67-690c-4004-8949-92811b6193a9_1484x1060.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>Information attached to a component, called metadata, can record which mixer models it applies to or whether it has been approved. The team uses metadata to organize content and to select the right material for each publication. Shared instructions must be accurate for every model that uses them. When one model needs different steps, the content has to preserve that difference rather than force a single version into every manual.</p><h2>The Role DITA Plays</h2><p>The Darwin Information Typing Architecture (DITA) is an open standard for organizing structured content. It defines topic types such as tasks, concepts, and references. In DITA, a component is usually a topic, and a publication is defined by a map.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!PHC8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!PHC8!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 424w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 848w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 1272w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!PHC8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png" width="1484" height="1010" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1010,&quot;width&quot;:1484,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2305074,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4ea2ed1-814f-4701-af0b-1a4c6e0c3612_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!PHC8!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 424w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 848w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 1272w, https://substackcdn.com/image/fetch/$s_!PHC8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F037aac86-cd70-49f9-9950-d9271c820fab_1484x1010.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>A map works sort of like a recipe. It lists which topics a publication needs, where each one is stored, and how they are ordered and nested. That order and nesting become the table of contents. Maps can record how topics relate to one another so the published output can include related links. It supplies context, too. The cleaning topic doesn&#8217;t name a model, so it can appear in any manual; the map for a tilt-head model is what places it in that model&#8217;s manual. The map never changes the topics it lists.</p><p>At publishing time, a publishing engine such as the open-source DITA Open Toolkit does the cooking. It reads the map, retrieves the topics it points to, and produces the PDF or website. Because a map is a set of instructions, the five mixer manuals can be five maps that point to the same cleaning topic without copying it.</p><p>A CCMS like <strong><a href="https://help.heretto.com/en/heretto-ccms/heretto-ccms-overview">Heretto</a></strong> provides the environment for authoring, reviewing, reusing, localizing, and publishing that content. DITA describes how the content is organized; the CCMS is where the team manages it.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!GW4r!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!GW4r!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 424w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 848w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 1272w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!GW4r!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png" width="1484" height="941" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/a03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:941,&quot;width&quot;:1484,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1877733,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd35f2b9-9480-4b0b-ac29-4c1e6868d215_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!GW4r!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 424w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 848w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 1272w, https://substackcdn.com/image/fetch/$s_!GW4r!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa03828e0-8648-4763-b7a9-4f5c52252a86_1484x941.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Why Would A Team Change How It Produces Technical Documentation?</h2><p>Now suppose the mixer company adds a sixth model that shares most of its features with an existing mixer. With managed components, the team creates a map for the new manual that points to approved topics and writes only the instructions for what is different. Reviewers focus on the new material and on whether the shared topics are correct for the new model, rather than treating the whole manual as a new document.</p><p>The benefit grows with the amount of shared content a team maintains across products, releases, and languages. Writers spend less time synchronizing copies and more time on content customers are waiting for.</p><p>Reuse is one reason to evaluate a CCMS, especially if the team needs to publish one source to several output channels, such as a PDF manual and a support website or documentation portal. Some teams may identify a need for better version control or a more reliable way to coordinate reviews and approvals. The business case depends on which production problems an organization has and how much they interfere with delivering documentation.</p><h2>How Does Reuse Reduce Translation Costs?</h2><p>Return to the 25 documents. While cleaning instructions stay unchanged, the company keeps using their approved translations. When the instructions change, a workflow that tracks components and their translations sends only the new or changed instructions for translation and they reuse existing translations of everything else. Translators receive one revised procedure per language rather than five copies.</p><p>Translation memory, a database of earlier translations, lets translators reuse sentences they have translated before. Source reuse adds a different benefit: shared instructions remain identical across publications. Separately maintained copies can drift apart, picking up small wording differences that create extra translation and review work. Keeping a common source prevents that drift.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!q9Y5!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!q9Y5!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 424w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 848w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 1272w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 1456w" sizes="auto, 100vw"><img src="https://substackcdn.com/image/fetch/$s_!q9Y5!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png" width="1484" height="864" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:864,&quot;width&quot;:1484,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1757784,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/219292968?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9f828d60-2f27-4c64-8544-71163b94c3ec_1484x1060.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!q9Y5!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 424w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 848w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 1272w, https://substackcdn.com/image/fetch/$s_!q9Y5!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F71289183-7671-4401-9884-5c0d7f6b3c14_1484x864.png 1456w" sizes="auto, 100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M" tabindex="0" type="button"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M" tabindex="0" type="button"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>In <em><strong><a href="https://ditametrics.xmlpress.net/">DITA Metrics 101</a> </strong></em>(XML Press), <strong><a href="https://www.linkedin.com/in/marklewisflorida/">Mark Lewis</a></strong> explains that many translation vendors charge, at a lower rate, to process text that matches an existing translation. Leaving unchanged, previously translated components out of the translation package can avoid those charges. In <em>Managing Enterprise Content</em>, Ann Rockley adds that separating content from formatting can reduce the work of laying out translated publications.</p><p>To estimate the financial benefit, the mixer company would compare its current translation and formatting charges with the expected charges under the new workflow, counting the translation-memory discounts it receives today. The difference shows the additional savings that come from changing how the company manages its source content.</p><h2>Why Isn&#8217;t The Problem Obvious To Leadership?</h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/why-organizations-invest-in-a-ccms">
              Read more
          </a>
      </p>
   ]]></content:encoded></item></channel></rss>