<?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>Tue, 05 May 2026 11:27:46 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[We Sold Out Our First "AI Workshop For Tech Writers" — So We Added Another]]></title><description><![CDATA[Seats filled once already &#8212; if you want practical AI skills you can actually trust, this is your second shot (don't miss out!)]]></description><link>https://www.thecontentwrangler.com/p/we-sold-out-our-first-ai-workshop</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/we-sold-out-our-first-ai-workshop</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 04 May 2026 19:15:24 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!tSHp!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg"/><content:encoded><![CDATA[<p>We opened registration for the summer session of our <strong><a href="https://www.cambermast.com/events/ai-workshop-for-tech-writers-and-content-creators-summer-2026-k4f8n1?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=k4f8n1&amp;src=qr&amp;ad=the-content-wrangler">AI Workshop for Technical Writers and Content Creators</a></strong>, and the Wednesday cohort sold out.</p><p>Not &#8220;almost full.&#8221; Not &#8220;act now before the imaginary countdown clock starts sweating.&#8221;</p><h2><strong>Sold out!</strong></h2><p>That tells us something. Tech writers and content creators aren&#8217;t just curious about AI anymore. They&#8217;re trying to figure out how to use it.</p><p>Most of us have already experimented. We&#8217;ve summarized, rewritten, drafted, prompted, re-prompted, and stared at an answer that looked correct until it started gently lying.</p><p>That&#8217;s where this course comes in.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://www.cambermast.com/events/ai-workshop-for-tech-writers-and-content-creators-summer-2026-k4f8n1?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=k4f8n1&amp;src=qr&amp;ad=the-content-wrangler" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!tSHp!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 424w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 848w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!tSHp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg&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;:null,&quot;alt&quot;:&quot;AI Workshop for Tech Writers and Content Creators illustration&quot;,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:&quot;https://www.cambermast.com/events/ai-workshop-for-tech-writers-and-content-creators-summer-2026-k4f8n1?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=k4f8n1&amp;src=qr&amp;ad=the-content-wrangler&quot;,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="AI Workshop for Tech Writers and Content Creators illustration" title="AI Workshop for Tech Writers and Content Creators illustration" srcset="https://substackcdn.com/image/fetch/$s_!tSHp!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 424w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 848w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!tSHp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F786f5d85-5e84-40fd-bb80-7be653bbe7c2_1536x1024.jpeg 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Instructor <strong>Bill Raymond</strong> teaches this 7-week, hands-on <strong><a href="https://www.cambermast.com/events/ai-workshop-for-tech-writers-and-content-creators-summer-2026-k4f8n1?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=k4f8n1&amp;src=qr&amp;ad=the-content-wrangler">virtual workshop</a></strong> for people who want more than AI party tricks. It&#8217;s built for writers and content pros who need practical ways to use AI with more control, better judgment, and fewer &#8220;why did it say that?&#8221; moments.</p><p>Because the first class sold out, we&#8217;ve added a second cohort.</p><p>The new session meets online <strong>Tuesdays, July 14 &#8211; August 25, 2026, from 10 a.m. to 12 p.m. PT</strong>.</p><p><strong><a href="https://www.cambermast.com/events/ai-workshop-for-tech-writers-and-content-creators-summer-2026-k4f8n1?utm_source=qr&amp;utm_medium=offline&amp;utm_campaign=events&amp;utm_content=k4f8n1&amp;src=qr&amp;ad=the-content-wrangler">Learn more and register</a></strong>.</p><blockquote><p>&#128176; Use discount code <strong>TCW</strong> at checkout to save <strong>10%</strong>. &#128176;</p></blockquote>]]></content:encoded></item><item><title><![CDATA[Why Some AI Tools Say “No” — And Others Don’t Even Blink]]></title><description><![CDATA[What &#8220;uncensored&#8221; AI reveals about how all AI systems are designed, governed, and quietly opinionated]]></description><link>https://www.thecontentwrangler.com/p/why-some-ai-tools-say-no-and-others</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/why-some-ai-tools-say-no-and-others</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 01 May 2026 15:31:12 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!eI97!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png"/><content:encoded><![CDATA[<p>You ask an AI for something. Nothing wild. Nothing illegal. Just&#8230; specific. Maybe a little spicy. Maybe just a little too real.</p><p><strong>And suddenly the tool clutches its pearls. &#187;&gt; &#8220;I can&#8217;t help with that!&#8221;</strong></p><p>Or worse, it <em>can</em> help&#8212;but only after it&#8217;s rewritten your request into something so polite and sanitized it sounds like it&#8217;s applying for a job in corporate compliance.</p><p>Meanwhile, somewhere else on the internet, another AI happily produces exactly what you asked for&#8212;no moral lecture, no creative editing, no hall monitor energy.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!eI97!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!eI97!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!eI97!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!eI97!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!eI97!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!eI97!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_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;:1991326,&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/194855319?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_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_!eI97!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!eI97!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!eI97!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!eI97!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5c4fdf3d-0ac2-459f-82c3-c3ecbc4a0f01_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>So What Gives?</h3><p>It&#8217;s tempting to think one AI is &#8220;better&#8221; and the other is &#8220;worse.&#8221; Or that one is &#8220;censored&#8221; and the other is &#8220;free.&#8221; But that&#8217;s not really what&#8217;s happening.</p><p>What you&#8217;re seeing is the result of <strong>design decisions</strong>. Not intelligence. Not morality. Design.</p><h2>There&#8217;s No Such Thing As &#8220;Neutral AI&#8221;</h2><p>Every AI system comes with opinions baked in. Not the model&#8217;s opinions, exactly, but the opinions of the people who built, tuned, and deployed it.</p><p>Those opinions show up in a few predictable places:</p><ul><li><p>What data the model was trained on</p></li><li><p>What kinds of outputs it was rewarded or penalized for producing</p></li><li><p>What filters sit in front of it, watching your prompt like a suspicious librarian</p></li><li><p>What filters sit behind it, quietly rewriting its answers after the fact</p></li></ul><p>By the time you type your request, you&#8217;re not talking to a raw model. You&#8217;re talking to a <strong>governed system</strong>. And that system has rules it is supposed to follow.</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/why-some-ai-tools-say-no-and-others">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[June 2026 Educational Webinars]]></title><description><![CDATA[The Content Wrangler hosts roughly 100 one-hour web presentations and talk shows each year and maintains an archive of over 800 shows available free-of-charge]]></description><link>https://www.thecontentwrangler.com/p/june-2026-educational-webinars</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/june-2026-educational-webinars</guid><pubDate>Fri, 01 May 2026 15:31:02 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!42Xj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png"/><content:encoded><![CDATA[<p>The Content Wrangler <strong><a href="https://www.brighttalk.com/channel/9273">webinar channel</a></strong> continues to do what it does best &#8212; bring together people who actually know what they&#8217;re talking about and give them a full hour to prove it. </p><p>This June lineup covers the things tech writers keep circling back to: scaling content without breaking teams, making sense of content operations, getting into the field, and figuring out what AI is going to change next (and what it won&#8217;t, despite its enthusiasm). You&#8217;ll hear from practitioners, strategists, educators, and the occasional truth-teller who&#8217;s seen what happens when good intentions meet messy reality.</p><p>Each session runs for one hour, which is just enough time to learn something useful without questioning your life choices. And if your calendar has other plans &#8212; which it will &#8212; registering still gets you access to the on-demand recording after the live broadcast. That means you can watch when it suits you, pause when someone says something worth stealing, and pretend you were there all along.</p><p>If you&#8217;re new to the channel, there&#8217;s also a small detail worth mentioning: <strong>there are already more than 800 recorded one-hour educational sessions waiting for you.</strong> That&#8217;s a suspiciously large archive of hard-earned knowledge from people who&#8217;ve done the work, fixed the mistakes, and are willing to talk about both.</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_!42Xj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!42Xj!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3ca6d19b-9dc8-4980-8347-e8b69accebbb_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;:2381656,&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/192983017?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_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_!42Xj!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>&#128467;&#65039; [June 9] How to Scale Content Teams Without Slowing Delivery</h3><p>Join <strong><a href="https://www.linkedin.com/in/eslsinena/">Effie Sharon Sinena</a></strong>, Product Delivery Manager (Technical Documentation) at <strong><a href="https://www.lexmark.com/">Lexmark</a></strong> Research and Development Corporation (now part of Xerox), as she shares practical lessons from startups and fast-growing organizations on building resilient content operations that don&#8217;t burn out your team or compromise output.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664991?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664991?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 10] Introduction to Content Operations for Tech Writers</h3><p>Join <strong><a href="https://www.linkedin.com/in/rahelannebailie/">Rahel Anne Bailie</a></strong>, Content Operations Strategist at <strong><a href="https://www.content-seriously.com/">Content Seriously</a></strong>, as she demystifies the difference between content supply chains and lifecycles&#8212;and reveals where hidden inefficiencies can quietly drain resources.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/663407?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/663407?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 11] The Cerberus Project: How to Enter Tech Writing</h3><p>Join <strong><a href="https://www.linkedin.com/in/maria-haque/">Maria Haque</a></strong>, teacher at <strong><a href="https://pace.ca/">PACE - Academy for Gifted Children</a></strong>, and <strong><a href="https://www.linkedin.com/in/christinamayr/">Christina Mayr</a></strong>, Documentation Team Manager &amp; Senior Information Architect at <strong><a href="https://www.epicgames.com/site/home?lang=en-US">Epic Games</a></strong>, as they unpack how newcomers can break into the field using <em>The Cerberus Project</em> as a practical case study.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664429?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664429?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 16] The Content Integrity Model: Framework for an AI Age</h3><p>Join <strong><a href="https://www.linkedin.com/in/rahelannebailie/">Rahel Bailie</a></strong>, Content Solutions Strategist at <strong><a href="https://www.content-seriously.com/">Content Seriously</a></strong>, as she introduces the <strong><a href="https://open.substack.com/pub/rahelannebailie/p/the-content-integrity-model?utm_campaign=post-expanded-share&amp;utm_medium=web">Content Integrity Model</a> </strong>&#8212; a practical framework designed to help you align your content strategy with organizational goals while ensuring editorial quality, operational efficiency, and a resilient infrastructure.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664437?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664437?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 16] Structuring Prompts for Technical Communication</h3><p>Join Professor <strong><a href="https://www.linkedin.com/in/lance-cummings-phd/">Lance Cummings</a></strong> of the <strong><a href="https://uncw.edu/">University of North Carolina Wilmington</a></strong> as he reveals why prompt structure (not just length) determines whether your AI-generated content meets professional standards. Explore a practical framework for structuring prompts using three core components: task, context, and content. </p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664192?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664192?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 17] Proving Better UX Content Is Worth The Investment</h3><p>Join Julia Warrender, Senior Content Strategist at TELUS, as she shares a practical framework that connects traffic, conversion, and customer value to estimate the real financial impact of poor content. Julia will demonstrate her simple &#8220;Content Impact Model,&#8221; show you how to build one even with imperfect data, and guide you through using it to influence prioritization and decision-making.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665745?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665745?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 18] Reinventing Yourself While AI Changes the Rules</h3><p>Join <strong><a href="https://www.linkedin.com/in/raegen-pietrucha/">Raegen Pietrucha</a></strong>, author, career coach, and consultant dedicated to empowering writers, as she explores why we get stuck in our routines, how confidence can quietly morph into complacency, and what it takes to break free. You&#8217;ll learn to spot subtle signals that you&#8217;re ready for change, recognize obstacles that hold you back, and ask yourself the right questions to reignite your initiative.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665325?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665325?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 18] Better GenAI Content Starts With Human Oversight</h3><p>Even minor errors can create outsized problems &#8212; <strong><a href="https://www.linkedin.com/in/1charlesdowdell/">Charles Dowdell</a></strong>, Manager and Consultant at <strong><a href="https://wisdomino.com/">Wisdomino Corp</a></strong> (transitioning from Komatsu), will share real-world examples where small mistakes led to big consequences. Explore proven methods for content quality control that you can implement right away. </p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664978?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664978?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 23] A Solo Tech Writer&#8217;s Lessons, Missteps, Wins Adopting AI</h3><p>Join us for a chat with <strong><a href="https://www.linkedin.com/in/sowjenyaparthasarathy/">Sowjenya Parthasarathy</a></strong>, Technical Writer at <strong><a href="https://funnel.io/">Funnel</a></strong>, as she shares her approach to analyzing user intent using search data, support queries, and behavioral tools. Discover how these insights can shape more effective AI-powered conversations with your users&#8212;even if you lack enterprise resources.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665181&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.brighttalk.com/webcast/9273/665181"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [June 25] It&#8217;s Time To Start Treating Content As Infrastructure</h3><p><strong><a href="https://www.linkedin.com/in/josephdigitalcontent/">Joseph Phillips</a></strong>, Content Infrastructure Strategist at <strong><a href="https://examinedweb.com/">The Examined Web</a></strong>, will reveal how organizations waste resources by viewing content as a commodity rather than as critical operational infrastructure. Explore practical steps for shifting your mindset and operations toward sustainable, scalable content practices.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665568?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665568?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></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></p>]]></content:encoded></item><item><title><![CDATA[When AI Meets A Leather Harness And Loses Its Nerve]]></title><description><![CDATA[What a simple image prompt reveals about safety filters, cultural blind spots, and why AI quietly rewrites what it doesn&#8217;t understand]]></description><link>https://www.thecontentwrangler.com/p/when-ai-meets-a-leather-harness-and</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/when-ai-meets-a-leather-harness-and</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 29 Apr 2026 15:31:08 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!numb!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png"/><content:encoded><![CDATA[<p>I&#8217;ve been doing a little science experiment with AI image generators, which is how middle-aged gay men now spend their time instead of <strong><a href="https://www.facebook.com/groups/241714486822603/">knitting</a></strong> or developing meaningful upper body strength.<br><br>The assignment was simple: generate a photorealistic image of a man wearing a <strong><a href="https://www.amazon.com/leather-harnesses-men/s?k=leather+harnesses+for+men">leather harness</a></strong>. Not porn. Not a dungeon scene. Nor a <strong><a href="https://www.them.us/story/what-is-bdsm">BDSM</a></strong> image. Just a stylish, real-world, Palm Springs&#8211;appropriate <strong><a href="https://www.charliebymz.com/collections/leather-top-harnesses-all?srsltid=AfmBOooUOmf18w7RHWQCR_DKjKty45fKV_AblfM8UqBrm5i_vWP4Sm5H">man in a harness</a></strong>.<br><br>What followed was less &#8220;art generation&#8221; and more &#8220;negotiation with a very polite (but deeply anxious) hall monitor.&#8221;</p><blockquote><p><strong>First attempt:</strong> BLOCKED! Apparently a harness, even in daylight, suggests I might be moments away from asking for something involving handcuffs and poor decision-making.</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_!numb!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!numb!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!numb!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!numb!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!numb!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!numb!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/757ba00a-8ac3-44ea-b322-4632c6094b56_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;:2266414,&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/194858306?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_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_!numb!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!numb!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!numb!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!numb!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F757ba00a-8ac3-44ea-b322-4632c6094b56_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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><br><strong>Second attempt:</strong> success&#8230; sort of. The man appeared wearing a harness over a fancy midcentury short sleeve dress shirt, which is a bit like wearing underwear over jeans. Technically possible. Otherwise, incorrect.</p></blockquote><p></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_!1cnu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!1cnu!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!1cnu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1536,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2567379,&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/194858306?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.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_!1cnu!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!1cnu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd67e3f88-5086-4b69-be03-708adfa72e1d_1024x1536.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>I adjusted the prompt. Clarified intent. Emphasized &#8220;fashion,&#8221; &#8220;editorial,&#8221; &#8220;not sexual.&#8221; </p><p>The AI nodded, took notes, and then produced a man standing by a pool&#8230; wearing a harness&#8230; and still clinging to that 70s-style print shirt like it was his emotional support garment.<br><br>At this point, I wasn&#8217;t generating images. I was coaching.</p><p>Eventually (after removing, rewording, softening, reframing, and essentially whispering to the machine, &#8220;I promise this is just a nice man enjoying the sunshine&#8221;) it finally complied.</p><blockquote><p><strong>Shirtless. Harness on bare chest. Poolside. Palm Springs. Correct. Victory!</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_!Eloz!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Eloz!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 424w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 848w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Eloz!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1536,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:418215,&quot;alt&quot;:null,&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/194858306?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Eloz!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 424w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 848w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!Eloz!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff2a7ff76-852e-454d-bfbb-6606b60a3c62_1024x1536.jpeg 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>But here&#8217;s the interesting part:</strong> nothing I originally asked for was inappropriate.<br><br>What the system kept doing was correcting me (not for accuracy, but for <em>safety</em>). It wasn&#8217;t reading culture. It was reading patterns. Somewhere in its training data, &#8220;harness&#8221; lives in a very specific neighborhood, and even when you move it to Palm Springs in broad daylight by the pool, the AI image generator still thinks it might turn into a situation requiring a safe word.<br><br>So it hedges. It adds clothing. It tones things down. It quietly rewrites your request into something it feels better about.</p><p>Not more accurate. Just&#8230; safer. And that&#8217;s the issue. Because harnesses aren&#8217;t just <strong><a href="https://boynextdoormenswear.com/collections/harnesses?srsltid=AfmBOopg5O4ctyQ_jQ5t-JhDU1mgYPQ4TJ-yrli3VWf8IfIoPni7QT0Y">fetish gear</a></strong> anymore. They&#8217;re <strong><a href="https://www.xpressharness.com/blogs/news/the-ultimate-fashion-harness-guide?srsltid=AfmBOorCfatzNYRGeWBMflkqJSPcRW2mKvw8ZYtvQYtLFDJAh60tqQst">fashion</a></strong> (check out <strong><a href="https://www.pinterest.com/ideas/queer-harness/951476598042/">Pinterest</a></strong>). For some, they&#8217;re <strong><a href="https://www.etsy.com/market/gay_pride_harness">Pride</a></strong>, they may be seen at pool parties, music festivals, and in <strong><a href="https://www.instagram.com/reel/DWo2kx_M4Cz/">Instagram ads</a></strong> that somehow know exactly when you&#8217;re feeling emotionally available and financially irresponsible.<br><br>But the AI hasn&#8217;t caught up. It&#8217;s still operating like a well-meaning chaperone who&#8217;s convinced that if you remove one more button, society will collapse. </p><p>Today it&#8217;s a harness. Tomorrow it&#8217;s something else the model doesn&#8217;t fully understand but feels oddly nervous about. And honestly, that&#8217;s the real story here. Not leather. Not sex. But what happens when a machine sees a cultural signal, panics slightly, and mistakes its own outdated assumptions for good judgment.<br><br>Also, for the record, if you ever see someone wearing a leather harness over a dress shirt at a Palm Springs pool, please check on them. They may likely be in distress. &#129315;</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[The “Car Wash Error” — Why AI Makes Your Documentation Sound Better (And Be Wrong)]]></title><description><![CDATA[AI can polish your content until it shines &#8212; and quietly remove the parts that matter most]]></description><link>https://www.thecontentwrangler.com/p/the-car-wash-error-why-ai-makes-your</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-car-wash-error-why-ai-makes-your</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 28 Apr 2026 15:31:07 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!g7f9!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png"/><content:encoded><![CDATA[<p>There&#8217;s a moment that happens now with unsettling regularity. You paste a chunk of documentation into an AI tool. It comes back cleaner. Tighter. More readable. The sentences behave themselves. The tone sounds like someone who drinks water and meets deadlines.</p><p><strong>&#128073;&#127998; You think, &#8220;Well, that&#8217;s better.&#8221;</strong></p><p>Then you look again.</p><p><strong>&#128073;&#127998; </strong>The warning is gone.<br><strong>&#128073;&#127998; </strong>The prerequisite has been politely implied into nonexistence.<br><strong>&#128073;&#127998; </strong>The conditional step has been simplified into something that would work beautifully in a world where nothing ever goes wrong.</p><p>Nothing looks broken. And yet, everything is just slightly&#8230; off.</p><p>This is what some call <strong>the car wash error.</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_!g7f9!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!g7f9!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!g7f9!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ef07887c-5544-4d7d-9f6d-1bcf5768b6d0_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;:1879435,&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/193082189?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_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_!g7f9!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!g7f9!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef07887c-5544-4d7d-9f6d-1bcf5768b6d0_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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 The Car Wash Error?</h2><p>It&#8217;s not a formal term. We won&#8217;t find it in industry research papers. It&#8217;s a practical <strong><a href="https://www.reddit.com/r/PromptEngineering/comments/1r993d4/the_car_wash_problem_isnt_an_ai_failure_its_a/?utm_source=share&amp;utm_medium=web3x&amp;utm_name=web3xcss&amp;utm_term=1&amp;utm_content=share_button">observation</a></strong> from people who&#8217;ve watched content go into a machine and come out looking <em>cleaner</em> while quietly losing the important parts; the ones that mattered.</p><p>Put simply, the <strong>car wash error</strong> happens when AI makes content smoother and easier to read, but not helpful in real-world situations. The content goes in with dents and bugs &#128030; on the windshield. It comes out polished. </p><p>But then, somewhere along the way, a side mirror falls off. </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_!siyq!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!siyq!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 424w, https://substackcdn.com/image/fetch/$s_!siyq!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 848w, https://substackcdn.com/image/fetch/$s_!siyq!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 1272w, https://substackcdn.com/image/fetch/$s_!siyq!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!siyq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic" width="1456" height="521" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:521,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:42683,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193082189?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!siyq!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 424w, https://substackcdn.com/image/fetch/$s_!siyq!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 848w, https://substackcdn.com/image/fetch/$s_!siyq!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 1272w, https://substackcdn.com/image/fetch/$s_!siyq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F035354fd-6e99-4754-a912-79f6877d3668_1628x582.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Source: ChatGPT</strong></figcaption></figure></div>
      <p>
          <a href="https://www.thecontentwrangler.com/p/the-car-wash-error-why-ai-makes-your">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[If You Wouldn’t Trust It At 35,000 Feet, Don’t Trust It In Your Docs]]></title><description><![CDATA[In high-stakes environments, polished text without validation is just unnecessary risk wearing good formatting]]></description><link>https://www.thecontentwrangler.com/p/if-you-wouldnt-trust-it-at-35000</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/if-you-wouldnt-trust-it-at-35000</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 28 Apr 2026 15:31:00 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!HBOj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic"/><content:encoded><![CDATA[<p>Here&#8217;s a fun little thought experiment for tech writers, doc managers, and the leaders currently saying things like, <strong>&#8220;Couldn&#8217;t AI just do most of this now?&#8221;</strong></p><p>You&#8217;re at the airport. You&#8217;ve got your tragic little sandwich in a paper bag, your phone battery is hanging on by a thread, and the gate agent smiles as she scans your boarding pass.</p><p>Then she says, almost as an afterthought, &#8220;Just so you know, the maintenance procedures, safety documentation, and operating guidance for this aircraft were autogenerated by a large language model. No human reviewed any of it, but the output was looks great.&#8221;</p><p>Do you keep walking down the jet bridge? Would you really board that plane?</p><p>Or do you suddenly decide that maybe this is the perfect time to reconnect with <strong><a href="https://www.amtrak.com/">Amtrak</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_!HBOj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!HBOj!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 424w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 848w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 1272w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!HBOj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1536,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:159026,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/194548083?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!HBOj!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 424w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 848w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 1272w, https://substackcdn.com/image/fetch/$s_!HBOj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F304077d8-1e9f-4290-8f9b-aac5023f3522_1024x1536.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>That, in a nutshell, is the conversation a lot of us are being asked to have about AI-generated technical documentation. Only instead of saying it plainly, some leaders prefer to dress it up in phrases like &#8220;content acceleration,&#8221; &#8220;operational efficiency,&#8221; and &#8220;reimagining the authoring workflow,&#8221; which is executive dialect for &#8220;we&#8217;re about to try something reckless and would like it to sound visionary.&#8221;</p><h2>The Trouble With Text That Sounds Smart</h2><p>This is <strong><a href="https://stackoverflow.blog/2025/06/30/reliability-for-unreliable-llms/">the problem with LLMs.</a></strong> They&#8217;re very good at producing language that appears to know what it&#8217;s talking about. They sound calm, competent, and confident. They sound like the kind of person who&#8217;d use the phrase &#8220;best practice&#8221; without once stopping to ask whether the practice in question might get someone electrocuted.</p><p>And that&#8217;s exactly what makes them dangerous in high-stakes documentation environments.</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/if-you-wouldnt-trust-it-at-35000">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Why Technical Writers Should Care About Mechatronics]]></title><description><![CDATA[If you can&#8217;t explain how the system behaves, you can&#8217;t document it]]></description><link>https://www.thecontentwrangler.com/p/why-technical-writers-should-care-867</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/why-technical-writers-should-care-867</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 27 Apr 2026 15:30:48 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!c19n!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic"/><content:encoded><![CDATA[<blockquote><p><strong>There was a time when products had the decency to be one thing.</strong></p></blockquote><p>A toaster toasted. A manual explained how not to electrocute yourself while using it &#8212; specifically, &#8220;<strong><a href="https://www.iso.org/obp/ui#iso:grs:7010:P026">do not use in bathtub or shower</a></strong>,&#8221; which suggests at least one person looked at a toaster and thought, <em>sure, let&#8217;s bring this into the one room specifically designed for water.</em> Everyone went home slightly safer and mildly warmed.</p><p>Now you&#8217;re handed a product that contains sensors, firmware, a touchscreen, a motor, three safety interlocks, and a support article that says, &#8220;Press the button.&#8221;</p><p>&#128073;&#127998; Which button? <br>&#128073;&#127998; What happens next?<br>&#128073;&#127998; Why doesn&#8217;t that happen sometimes?</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!c19n!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!c19n!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 424w, https://substackcdn.com/image/fetch/$s_!c19n!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 848w, https://substackcdn.com/image/fetch/$s_!c19n!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 1272w, https://substackcdn.com/image/fetch/$s_!c19n!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!c19n!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic&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;:89467,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/194527552?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!c19n!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 424w, https://substackcdn.com/image/fetch/$s_!c19n!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 848w, https://substackcdn.com/image/fetch/$s_!c19n!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 1272w, https://substackcdn.com/image/fetch/$s_!c19n!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2879ac-ba0b-48b2-9ead-cf0416f9d296_1600x900.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>And why the machine is <strong><a href="https://www.rd.com/article/vcr-clock-blinking-12-00/">blinking at them</a></strong> like it knows something they don&#8217;t &#8212; which, historically, has not gone well for humans. If you need a cultural reference, think of the VCR clock blinking &#8220;12:00&#8221; for eternity because no one in the household wanted to admit defeat and read the manual. There&#8217;s an entire <strong><a href="https://www.howtogeek.com/why-the-blinking-1200-became-the-ultimate-symbol-of-90s-tech-frustration/?link_source=ta_first_comment&amp;taid=69926c159c59c900011b9bfd&amp;utm_campaign=trueanthem&amp;utm_medium=social&amp;utm_source=facebook&amp;fbclid=IwY2xjawRPNcZleHRuA2FlbQIxMABicmlkETE0eHQ3cUVKbXAwYWZpbFdkc3J0YwZhcHBfaWQQMjIyMDM5MTc4ODIwMDg5MgABHjbiLzrWoBcmRf3ucu90LhRwttrZuWO2PtHce15mwjbjrmO6Qm3mnfdPqz7z_aem_deR7TtDUTSDkjqikUTLVXA">genre of jokes</a></strong> about this phenomenon. </p><p>Welcome to <strong><a href="https://builtin.com/articles/what-is-mechatronics">mechatronics</a></strong> &#8212; you&#8217;ve probably been documenting it for years without anyone bothering to tell you what it&#8217;s called.</p><h2>The Moment Products Stopped Being Polite</h2><p><strong><a href="https://www.mtu.edu/applied-computing/undergraduate/mechatronics/what-is/">Mechatronics is what happens</a></strong> when engineers stop pretending their disciplines live in separate apartments and start sharing a kitchen. It blends mechanical engineering, electronics, software, and control systems into one integrated system. Not &#8220;a machine plus some code,&#8221; but a system designed to sense, decide, and act.</p><p><strong>Why does this matter?</strong> Because this isn&#8217;t just a stack of technologies. It&#8217;s a <strong><a href="https://www.imeche.org/industry-sectors/mechatronics-informatics-and-control/about-the-mechatronics-informatics-and-control-group/what-is-mechatronics">design philosophy</a></strong> that aims to help us ensure everything works together from the start.</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/why-technical-writers-should-care-867">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[What Tech Writers Can Learn From Designer’s Frustration With AI]]></title><description><![CDATA[Christopher Noessel&#8217;s post about Claude Design is really about something bigger: why expert thinking still matters in the age of machine-generated output]]></description><link>https://www.thecontentwrangler.com/p/what-tech-writers-can-learn-from</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-tech-writers-can-learn-from</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 24 Apr 2026 15:30:30 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!l5L4!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp"/><content:encoded><![CDATA[<blockquote><p><strong>Getting a machine to spit out a pile of plausible-looking output is not the same as doing the work well.</strong></p></blockquote><p>Tech writers should pay close attention to this distinction, because it applies to us just as much as it applies to software designers.</p><p><strong><a href="https://www.linkedin.com/in/chrisnoessel">Christopher Noessel</a></strong> (follow him on <strong><a href="https://christophernoessel.medium.com/">Medium</a></strong>) recently shared an <strong><a href="https://christophernoessel.medium.com/design-was-never-the-comps-what-i-learned-when-claude-design-dumped-a-dozen-screens-on-me-73893af464ae">interesting reflection</a></strong> on using Anthropic&#8217;s <strong><a href="https://claude.ai/design">Claude Design</a></strong>. He started with what seemed like a harmless experiment. He issued a design-related challenge to the tool and asked it to generate wireframes (low-fidelity, black-and-white structural blueprints focusing on page layout and functionality) and comps (high-fidelity, polished mockups showing the final visual design, colors, and typography). <br><br>Compared with another tool he had tried previously, the results were better. But better didn&#8217;t mean <em>useful</em>. Instead of helping him think through the problem, the AI handed him a large dump of finished-looking artifacts. And that, he realized, was the problem.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!l5L4!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!l5L4!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 424w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 848w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 1272w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!l5L4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp" width="898" height="772" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/6dc920f8-562d-4744-8934-812060821cc0_898x772.webp&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:772,&quot;width&quot;:898,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:49562,&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/194809316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.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_!l5L4!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 424w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 848w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 1272w, https://substackcdn.com/image/fetch/$s_!l5L4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6dc920f8-562d-4744-8934-812060821cc0_898x772.webp 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Too Much Output Creates A New Challenge</h2><p>The output looked impressive, but it did not help him understand the decisions behind it. For instance, it didn&#8217;t help him evaluate whether the work was sound. It didn&#8217;t build confidence, instead it just created the familiar modern sensation of <strong><a href="https://psychcentral.com/pro/how-information-overload-affects-the-brain">being handed too much stuff too fast</a></strong><a href="https://psychcentral.com/pro/how-information-overload-affects-the-brain"> </a>and being expected to clap. &#128079;</p><p><strong>That insight should feel very familiar to tech writers.</strong></p>
      <p>
          <a href="https://www.thecontentwrangler.com/p/what-tech-writers-can-learn-from">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[AI In Technical Documentation: What The Data Says (And What You Should Do About It)]]></title><description><![CDATA[The biggest obstacles to getting more value from AI isn't technological so much as organizational, structural, and painfully familiar]]></description><link>https://www.thecontentwrangler.com/p/ai-in-technical-documentation-what</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/ai-in-technical-documentation-what</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 22 Apr 2026 20:01:04 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!EiXA!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic"/><content:encoded><![CDATA[<p>There is a special kind of corporate enthusiasm &#127881; reserved for new tech. It usually arrives wearing a blazer (or <em>mock turtleneck shirt</em> designed by <strong><a href="https://en.wikipedia.org/wiki/Issey_Miyake">Issey Miyake</a></strong>), speaking in declarations, and implying that all prior human effort was adorable but oh-so inefficient. AI has inspired plenty of that. </p><p>Suddenly, people who never cared much about content structure, review cycles, or metadata are speaking as though a chatbot will descend from the heavens and sort out the last fifteen years of documentation neglect.</p><p>That <strong>isn&#8217;t</strong> what the data 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_!EiXA!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!EiXA!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!EiXA!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic&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;:127194,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193583500?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!EiXA!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!EiXA!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35c08337-76d9-4d10-8cec-94da36264558_1536x1024.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>The 2026 State Of AI In Technical Documentation</h2><p>The <strong><a href="https://www.promptitude.io/2026-state-of-ai-in-technical-documentation-report">2026 State of AI in Technical Documentation Report</a></strong>, based on responses from around 400 participants, most of them experienced technical communicators, paints a much more useful picture. AI is already part of our work. It is helping us do more work faster, but it&#8217;s not trusted enough to allow it to run wild. And the biggest obstacles to getting more value from AI in tech docs aren&#8217;t technological so much as organizational, structural, and painfully familiar.</p><p>Which is to say, the profession has not been rescued by a machine. Instead, it&#8217;s acquired a new assistant with a speed and truth problems.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!VkeU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!VkeU!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 424w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 848w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!VkeU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg" width="1456" height="837" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:837,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:373835,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/jpeg&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193583500?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8f01210a-c313-4878-b93f-5121d4874e85_2242x1264.heic&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_!VkeU!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 424w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 848w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!VkeU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fae310eeb-32ac-4847-833a-95ea89fd8f0a_2199x1264.jpeg 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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.promptitude.io/the-2026-state-of-ai-in-technical-documentation&quot;,&quot;text&quot;:&quot;Get The Report&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://www.promptitude.io/the-2026-state-of-ai-in-technical-documentation"><span>Get The Report</span></a></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-in-technical-documentation-what">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Governance, Frankenstein Docs, And The Very Expensive Cost Of Letting Content Run Wild]]></title><description><![CDATA[In the age of AI answer engines, technical documentation governance is no longer just a quality issue &#8212; it is a trust, risk, and revenue issue]]></description><link>https://www.thecontentwrangler.com/p/governance-frankenstein-docs-and</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/governance-frankenstein-docs-and</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 22 Apr 2026 15:30:59 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!twUp!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic"/><content:encoded><![CDATA[<blockquote><p><strong>A customer disaster story with a very modern lesson for tech writers and documentation leaders</strong></p></blockquote><p>A few years ago, while consulting with a financial services software company, I got pulled into one of those situations that starts with &#8220;a customer is upset&#8221; and ends with leadership acting stunned that documentation quality might affect customer retention.<br><br>Duh! &#128530;</p><p>The company sold an automated mortgage approval system to lenders. This wasn&#8217;t some whimsical app that <strong><a href="https://play.google.com/store/apps/details?id=app.mdbtdj.aurascopepro&amp;hl=en_US&amp;pli=1">guessed your aura</a></strong> or matched your leadership style to a breakfast pastry (&lt;&#8212; that&#8217;s not a thing, <em>yet</em>). It was serious software used in highly regulated environments, where customers needed clear, trustworthy guidance to deploy, configure, and use it correctly.</p><p>One customer had <em>had enough</em>. &#9995;&#127996;</p><p>They&#8217;d spent a long time (and wasted a lot of money) trying to make sense of the material the vendor had provided. And &#8220;provided&#8221; is <em>generous</em> at best.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!twUp!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!twUp!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!twUp!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!twUp!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!twUp!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!twUp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic&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;:471403,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/194313816?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!twUp!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!twUp!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!twUp!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!twUp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F14655a36-a229-4865-99e7-e99b46e8753c_1536x1024.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>What they&#8217;d actually received was less a set of docs and more a content yard sale assembled by well-meaning people who&#8217;d apparently never met a <strong><a href="https://www.heretto.com/blog/content-governance">governance policy</a></strong>. There were formal docs, some of which <em>may even have been</em> accurate. There were PDFs from marketing, training materials, spreadsheets from internal teams, reference docs, bug notes, release notes, future roadmap tidbits, links to files marooned in SharePoint, and yes, emails. </p><p>All of it had been bundled into one giant zip file, as if customers enjoy panning for truth in a river of miscellaneous corporate debris.</p><p><strong>They do not.</strong></p><p>After several frustrating meetings, the customer used the cancellation clause in their contract and walked away. They also threatened a lawsuit for breach of contract. Then the financial services press got wind of it, and other lenders who&#8217;d bought the same software also started to rethink their choices. Leadership panicked, which was understandable.</p><p>Because I was there to help the company mature its doc practices, I got sent onsite to find out what had gone wrong and help stop the bleeding. &#129656;</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/governance-frankenstein-docs-and">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Docs-as-a-Hot-Mess: Why AI Exposes Every Documentation Sin You Thought Was Hidden]]></title><description><![CDATA[How to tell when disconnected, under-governed content may be setting your AI answers up to fail]]></description><link>https://www.thecontentwrangler.com/p/docs-as-a-hot-mess-why-ai-exposes</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/docs-as-a-hot-mess-why-ai-exposes</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 20 Apr 2026 15:31:04 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!tprT!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic"/><content:encoded><![CDATA[<p>If you work in tech docs, you&#8217;ve probably heard of <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-your-docs-as-code-toolchain-is?utm_campaign=post-expanded-share&amp;utm_medium=web">Docs-as-Code</a></strong>, the idea that documentation should be created, managed, versioned, and maintained with the same discipline used for software source code. More recently, you may have run into <strong><a href="https://www.brighttalk.com/webcast/9273/610371?utm_source=brighttalk-portal&amp;utm_medium=web&amp;utm_content=end-to-end-testing&amp;utm_term=search-result-9&amp;utm_campaign=webcasts-search-results-feed">Docs-as-Tests</a></strong>, the idea that documentation can be treated as testable code and automatically checked against a product so accuracy doesn&#8217;t depend on crossed fingers, stale screenshots, and somebody muttering, &#8220;<em>I thought we updated that.</em>&#8221;</p><p>Both are real. Both are useful. Both sound like they arrive at work on time. &#9200;</p><p><strong>Docs-as-a-Hot-Mess is </strong><em><strong>different</strong></em><strong>.</strong></p><p>&#128073;&#127998; It isn&#8217;t a methodology. </p><p>&#128073;&#127998; It isn&#8217;t a best practice. </p><p>&#128073;&#127998; It isn&#8217;t a movement anyone should claim in public. </p><p><strong>It&#8217;s simply a label for a condition many organizations already have:</strong> docs produced by multiple internal groups, for multiple purposes, with multiple assumptions, and with <strong>no governing framework strong enough to reconcile any of it.</strong></p><p>The naming convention is really the only thing these categories have in common. </p><p>They all start with &#8220;<strong>Docs-as-</strong>,&#8221; which gives them a faint air of professionalism, much like putting a blazer on a bad decision. But where Docs-as-Code suggests rigor and Docs-as-Tests suggests verification, Docs-as-a-Hot-Mess describes what happens when nobody&#8217;s clearly modeled the logic underneath the content and then acts surprised when an AI answer engine turns that confusion into customer-facing prose.</p><p>That&#8217;s why we <em>need the term</em>. </p><p>A lot of documentation that looked &#8220;good enough&#8221; in the old world isn&#8217;t ready for AI retrieval in the new one. A help topic written for support engineers sits next to an onboarding guide written for customers. A release note we produced assumes context the reader doesn&#8217;t have. A troubleshooting article we crafted skips the event that starts the workflow. A procedure we carefully worded says &#8220;the user&#8221; does something, but never explains <em>which</em> <em>user</em>, in <em>what role</em>, <em>under what conditions</em>, or whether <em>the system</em> was supposed to handle it automatically instead.</p><p><strong>That isn&#8217;t guidance. That&#8217;s improv with screenshots.</strong></p><p>And AI answer engines, bless their tireless little hearts, are very good at finding disconnected scraps, flattening their differences, and serving them back as one smooth, confident answer. Which is great when your content is governed, structured, and semantically clear. <strong>If it isn&#8217;t, the machine doesn&#8217;t fix the mess. It scales it. Publicly.</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_!tprT!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!tprT!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!tprT!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!tprT!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!tprT!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!tprT!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic&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;:337701,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/194336725?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!tprT!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!tprT!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!tprT!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!tprT!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd57b1ca2-4971-491e-b760-02d5f0ff1232_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>AI Didn&#8217;t Create Our Mess, But Turned On The Lights So We Couldn&#8217;t Help But See It</h2><p>A customer asks a simple question. The AI assistant replies in seconds with the confidence of a man explaining olive oil at a dinner party. It has found a setup topic from the help center, a support note meant for internal use, a few release-note fragments, and an onboarding PDF that appears to have been updated during a period of low morale. It blends them into one polished answer. The answer is clear, direct, wrong in at least three ways, and just plausible enough to cause trouble.</p><p>This is usually the part where someone says, &#8220;Well, the AI <strong><a href="https://community.openai.com/t/ai-hallucinations-are-basically-randomized-thoughts/1139304/4">hallucinated</a></strong>.&#8221;</p><p>Sometimes it did. But often it&#8217;s doing something worse and far more understandable: <em><strong>it&#8217;s retrieving exactly what you gave it.</strong></em> </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/docs-as-a-hot-mess-why-ai-exposes">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[What Is The Content Integrity Model — And Why Should Tech Writers Care?]]></title><description><![CDATA[A useful framework for understanding why strong writing alone is not enough when content has to scale, support automation, and hold up under AI scrutiny]]></description><link>https://www.thecontentwrangler.com/p/what-is-the-content-integrity-model</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-the-content-integrity-model</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 20 Apr 2026 15:31:02 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!UCsT!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F025d8f5d-81fd-4168-a16f-78f7bdae88fb_1280x720.heic"/><content:encoded><![CDATA[<p>Technical writers trying to make sense of AI are being asked to perform a balancing act. One minute, we&#8217;re told AI will speed everything up, reduce friction, and transform the business. The next, we&#8217;re warned not to trust a word it says without checking the output like a suspicious aunt reviewing a cashier&#8217;s math. Then, before lunch, somebody wants to know why the chatbot gave a customer three different answers to the same question, all of them polished, plausible, and at least one of them, wrong &#8212;&nbsp;in a way that could create work for Support, Product, and possibly Legal.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Umtw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Umtw!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Umtw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic&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;:291882,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193116306?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Umtw!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Umtw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F658d8045-be61-41e1-b116-b016324dc49c_1536x1024.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>That&#8217;s where the idea of a <strong><a href="https://altuent.com/insights/content-integrity-model/">content integrity model</a></strong> becomes useful. It isn&#8217;t a formal standard with a grand governing body and a tasteful logo. It&#8217;s a practical way to think about whether the content feeding AI systems deserves to be trusted in the first place. Put plainly, it asks the questions technical writers should&#8217;ve been asking all along: where did this information come from, who verified it, is it still current, does it agree with related content, and can anybody trace how it got approved?</p><h2>What the Content Integrity Model Actually Means</h2><p>At heart, the content integrity model (as presented by <strong><a href="https://www.linkedin.com/in/rahelannebailie/">Rahel Anne Bailie</a></strong>) is less a branded framework than a disciplined habit of mind. <strong>It treats content as something that must be trustworthy before it can be useful</strong>, especially now that machines are reading, summarizing, and repackaging it for other people. It pushes you to look at content not merely as words arranged into a page, but as an asset with a source, a history, an owner, and consequences.</p><p>That matters because AI systems are very good at sounding sure of themselves even when they&#8217;re spectacularly wrong. They don&#8217;t hesitate and they don&#8217;t blush. They don&#8217;t bother to stop and say, &#8220;This section was last updated five years ago, so perhaps let&#8217;s proceed with caution.&#8221; They just produce answers with the confidence of a man explaining the health benefits of a supplement he found in a podcast ad.</p><p>If our underlying content is weak, generative AI output won&#8217;t improve. It&#8217;ll just become a smoother, faster delivery mechanism for confusing 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_!6Lfe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!6Lfe!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!6Lfe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic&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;:314741,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193116306?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!6Lfe!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!6Lfe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2166db11-d8ea-40bf-a19f-f83e28d7b47a_1536x1024.heic 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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 This Matters More Now Than It Did Before</h2><p>Before AI entered the chat, our <em>not-so-good content</em> mostly stayed where it was. A stale help page remained stale. A contradictory procedure confused only the unlucky few who stumbled upon it. A vague warning sat quietly in the corner, radiating menace (but not doing much until someone tripped over it.) The damage was real, but it was often localized.</p><p>AI flips the script. Once machines begin reading our content and turning it into answers, summaries, or guided experiences, our weak source content doesn&#8217;t stay politely tucked away. It gets amplified. Contradictions surface faster and gaps become more, well&#8230;obvious. Outdated docs get handed to our users as though they just came down from a mountain on stone tablets.</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/what-is-the-content-integrity-model">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[What Is Content Strategy?]]></title><description><![CDATA[Content strategy helps us meet business goals and project objectives]]></description><link>https://www.thecontentwrangler.com/p/what-is-content-strategy-e46</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-content-strategy-e46</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Sun, 19 Apr 2026 18:31:45 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!5J2x!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png"/><content:encoded><![CDATA[<p>Content strategy is the analysis and planning to develop a repeatable system that governs the management of content throughout the entire content lifecycle. Content strategists are business consultants who focus on the lifeblood of every organization: content. &#8212;&gt; Source: <strong><a href="https://thelanguageofcontentstrategy.com/">The Language of Content Strategy</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_!5J2x!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!5J2x!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!5J2x!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/2329c2d4-dda0-4809-89c6-46a81fc25d7e_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;:2367531,&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/117984091?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_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_!5J2x!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!5J2x!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2329c2d4-dda0-4809-89c6-46a81fc25d7e_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Content Strategy Is The Part No One Sees &#8212; Until It Breaks</h2><p>Most people think content strategy is about planning what to write. That&#8217;s part of it, but it&#8217;s not the part that saves us when things go sideways.</p><p>Content strategy is the system behind the content &#8212; the decisions that determine:</p><ul><li><p>why something exists</p></li><li><p>who it&#8217;s for</p></li><li><p>how it&#8217;s structured</p></li><li><p>where it shows up</p></li><li><p>and who&#8217;s responsible for keeping it accurate over time</p></li></ul><p>It&#8217;s what keeps content from becoming a scattered content hairball of &#8220;we should probably document that&#8221; moments.</p><p>It&#8217;s easy to spot the absence of content strategy pretty quickly. If our help center includes multiple articles that say almost the same thing, but not quite &#8212; chances are good, there&#8217;s no formal content strategy in place. <br><br>If our documentation includes a procedure that works until step four quietly assumes the user already know something no one bothered to explain to them, content strategy is lacking.<br><br>If our customers have to ask, &#8220;Which version is correct?&#8221; and the honest answer is&#8230; &#8220;it depends&#8221; &#8212; a content strategy is <em>maybe, probably, definitely</em> missing in action.</p><p>We don&#8217;t have a technical writing problem. We have a system problem.</p><p>For tech writers, this matters more now than in the past Our job isn&#8217;t just about producing clear instructions anymore. It&#8217;s about designing information so it holds up across systems, channels, and increasingly, AI-powered machines that read and reuse our content in ways we don&#8217;t control.</p><p>When content lacks structure and governance, it doesn&#8217;t just confuse readers &#8212; it confuses the systems trying to interpret it. AI doesn&#8217;t fix that. It amplifies it. If your documentation contradicts itself or buries important context, those issues don&#8217;t disappear when an AI assistant summarizes the content. They get repackaged into answers that sound confident whether they&#8217;re right or not. Research from the BBC has shown that generative AI can <strong><a href="https://www.bbc.co.uk/rd/blog/2023-09-generative-ai-news-summaries">misrepresent source material even when it&#8217;s trying to summarize it</a></strong>. </p><p>That&#8217;s where content strategy earns its keep. It&#8217;s what makes content consistent enough to trust, structured enough to reuse, and governed enough to maintain. Without it, every new piece of content adds a little more entropy. With it, content starts to behave like infrastructure &#8212; something you can build on instead of constantly patch.</p><p>A sound content strategy also changes how your work is perceived by others. When there&#8217;s no strategy, writing can look like a task anyone could do if they had the time. Writing is just typing, right? How hard can it be?<br><br>When there is a strategy, it becomes clear that someone has to think about how information fits together, how it evolves, and how it supports <em>both</em> users and the business. </p><p><strong>That someone is usually the tech writer &#8212; whether the job description says so or not.</strong></p><p>So if content strategy sounds abstract, it&#8217;s really not. It&#8217;s the difference between content that sort of works today and content that keeps working tomorrow. And in a world where your documentation feeds everything from help portals to AI-generated answers, that difference isn&#8217;t academic. It&#8217;s operational. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[A Content Goldmine Of Knowledge You Have Free Access To]]></title><description><![CDATA[800+ one-hour sessions packed with practical insight for tech writers and content strategists &#8212; all on The Content Wrangler channel on BrightTALK]]></description><link>https://www.thecontentwrangler.com/p/a-content-goldmine-of-knowledgeyou</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/a-content-goldmine-of-knowledgeyou</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Sun, 19 Apr 2026 15:30:59 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!O_aD!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png"/><content:encoded><![CDATA[<p>There&#8217;s a particular kind of optimism that shows up in technical organizations &#8212; the belief that somewhere, somehow, someone has already figured out the exact problem you&#8217;re dealing with. You just haven&#8217;t found their slides yet.</p><p>That optimism isn&#8217;t wrong. It&#8217;s just usually buried under 47 tabs, three half-read white papers, and a YouTube recommendation engine that thinks &#8220;AI hype explainer&#8221; is what you needed instead of something you can actually use on Monday morning.</p><p>Which brings us to a quieter, more useful <strong><a href="https://www.brighttalk.com/channel/9273">corner of the internet</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_!O_aD!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!O_aD!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!O_aD!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f7ae3fab-d706-4d82-8812-a6b3d68e3447_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;:2373350,&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/194626920?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_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_!O_aD!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!O_aD!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff7ae3fab-d706-4d82-8812-a6b3d68e3447_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>The Library You May Not Know You Needed</h2><p>If you spend your days wrangling content &#8212; shaping it, fixing it, defending it from well-meaning chaos &#8212; you eventually realize something: <strong>you don&#8217;t just need ideas. You need </strong><em><strong>tested thinking</strong></em><strong>. You need to hear how other teams solved the same mess you&#8217;re currently staring at.</strong></p><p>That&#8217;s what you&#8217;ll find on <strong><a href="https://www.brighttalk.com/channel/9273">The Content Wrangler channel</a></strong> on <strong><a href="https://www.BrightTALK.com">BrightTALK</a></strong> isn&#8217;t a highlight reel. It&#8217;s an archive &#8212; and a substantial one. </p><p><strong>More than 800 recorded sessions</strong>, most of them 60 minutes or so, covering everything from <strong><a href="https://www.brighttalk.com/search?q=contentops">content operations</a></strong> and governance to AI, <strong><a href="https://www.brighttalk.com/search?size=10&amp;rank=-webcast_relevance&amp;duration=0..&amp;contentType=webcast&amp;q=ltp">personalization</a></strong>, structured authoring, and the occasional existential crisis about whether anyone reads the docs. </p><p>And unlike the average &#8220;thought leadership&#8221; content that floats by on LinkedIn, these sessions tend to feature <strong>people who&#8217;ve actually done the work</strong> &#8212; <strong>and are willing to talk about what didn&#8217;t go smoothly along the way.</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_!ZdBe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ZdBe!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 424w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 848w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 1272w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ZdBe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png" width="1456" height="989" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:989,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1262718,&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/194626920?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.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_!ZdBe!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 424w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 848w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 1272w, https://substackcdn.com/image/fetch/$s_!ZdBe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22b77dee-370d-413b-8b52-80092f0cc2a8_2222x1510.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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">In addition to a library of of over 800 on-demand recordings, when subscribe to The Content Wrangler webinar channel you also will be invited to upcoming webinars and talk shows.</figcaption></figure></div><h2>Subscribe (It&#8217;s Free) And Save Yourself The Hunt</h2><p>You could keep searching for answers one blog post at a time, hoping the algorithm has a moment of clarity. Or you could <strong><a href="https://www.brighttalk.com/channel/9273">subscribe</a></strong> (it&#8217;s free) and give yourself a reliable place to go when you need ideas that have already survived contact with reality.</p><p>Subscribing means you&#8217;ll get notified about upcoming sessions, but more importantly, it means you&#8217;ll stop starting from scratch every time a new challenge lands on your desk. And if you&#8217;ve been in this field long enough, you know how often that happens.</p><p><strong><a href="https://www.brighttalk.com/channel/9273">Subscribe</a></strong>. Explore. Steal the good ideas. Avoid the bad ones.</p><p>And the next time someone asks, &#8220;Has anyone figured this out yet?&#8221; you&#8217;ll be able to say, &#8220;Yes. And I know exactly where to find them.&#8221; &#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>]]></content:encoded></item><item><title><![CDATA[Your Docs Are About To Start Talking — Are You Ready For What They’ll Say?]]></title><description><![CDATA[When AI gets a face, your content problems get a megaphone]]></description><link>https://www.thecontentwrangler.com/p/your-docs-are-about-to-start-talking</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/your-docs-are-about-to-start-talking</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Sat, 18 Apr 2026 17:45:45 GMT</pubDate><enclosure length="0" type="audio/mpeg" url="https://api.substack.com/feed/podcast/194619496/35e2d9b6b6eca55f2a4701318a9ee6c3.mp3"/><content:encoded><![CDATA[<p>In this short clip, <strong><a href="https://www.linkedin.com/in/dominikwever/">Dominik Wever</a></strong> (CEO and founder of <strong><a href="https://www.emerse.ai">Emerse.ai</a>; </strong>founder of <strong><a href="https://www.Promptitude.io">Promptitude</a>) </strong>makes a point tech writers need to hear before someone in leadership falls in love with a <strong><a href="https://elevenlabs.io/lip-sync/ai-talking-avatar">talking avatar</a></strong> without understanding what&#8217;s needed to make them work well.</p><p>Virtual humans don&#8217;t understand our products. They don&#8217;t apply sound judgment. They don&#8217;t magically clean up our vague, inconsistent, or poorly governed docs. They simply turn our content into answers and deliver those answers with a face, a voice, and far more confidence than your source material may deserve.</p><p><strong>That&#8217;s the real issue.</strong> </p><p>The interface may look polished, but the underlying system is still drawing from whatever content you gave it. If your docs are messy, contradictory, or imprecise, the virtual human won&#8217;t fix that. It&#8217;ll perform it.</p><p>For tech writers, that means our jobs are changing in important ways. We&#8217;re no longer writing only for people who read what we write. We&#8217;re increasingly writing for systems that retrieve, assemble, and speak on our behalf. And those systems don&#8217;t handle ambiguity with the grace of a seasoned support rep. They just answer and keep moving.</p><p>Watch the clip. Then ask yourself a blunt question: <strong>if your docs started talking today, would you trust what they&#8217;d say? &#129312;</strong></p><div><hr></div><blockquote><p>If you&#8217;re interested in learning about conversational interfaces, stop by the <strong><a href="https://www.emerse.ai">Emerse.ai</a></strong> website and explore <strong><a href="https://www.emerse.ai/#how-it-works">how it works</a></strong> and check out their <strong><a href="https://www.emerse.ai/training-library">virtual training library</a></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_!EVAq!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!EVAq!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 424w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 848w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 1272w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!EVAq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png" width="2056" height="920" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:920,&quot;width&quot;:2056,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:512145,&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/194619496?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f49cbea-f1a9-46a5-985d-d843871fa68e_2056x1150.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_!EVAq!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 424w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 848w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 1272w, https://substackcdn.com/image/fetch/$s_!EVAq!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F07892957-d6d4-46a8-b755-8b54ef3c0272_2056x920.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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><hr></div><p></p>]]></content:encoded></item><item><title><![CDATA[Why Structured Content Alone Is Not Enough In An AI-Powered Documentation World]]></title><description><![CDATA[Ontology, Epistemology, and Phenomenology for Technical Writers in the Age of AI]]></description><link>https://www.thecontentwrangler.com/p/why-structured-content-alone-is-not</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/why-structured-content-alone-is-not</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 17 Apr 2026 15:30:57 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!E6yn!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8abc3681-29ce-4e93-81ae-c6d35d203c46_1536x1024.heic"/><content:encoded><![CDATA[<h2>The Meeting Everyone Pretends Is Fine</h2><p>There is a particular kind of meeting happening in offices everywhere right now, and it usually begins with someone from leadership saying something cheerful and faintly menacing like, <strong>&#8220;With AI, we should be able to create documentation much faster.&#8221;</strong></p><p>This is the sort of sentence that sounds harmless until you realize it is often followed by a silence in which every tech writer in the room is expected to smile politely while their profession is reduced to &#8220;person who types words into boxes.&#8221;</p><blockquote><p><strong>The implication is hard to miss.</strong> If AI can generate sentences, and structured content can feed the machine, then surely the technical writer is now just an expensive hallway monitor for punctuation and product names.</p></blockquote><p>Unfortunately for the people saying this, that is not how any of this works.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!lyeM!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!lyeM!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 424w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 848w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 1272w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!lyeM!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic" width="1200" height="873" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/16071222-f14c-4415-9c52-402b5886d267_1200x873.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:873,&quot;width&quot;:1200,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:136715,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/191763789?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!lyeM!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 424w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 848w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 1272w, https://substackcdn.com/image/fetch/$s_!lyeM!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F16071222-f14c-4415-9c52-402b5886d267_1200x873.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Yes, AI can generate language. Quite a lot of it, quickly. It can produce whole fields of prose with the confidence of a man at brunch <strong><a href="https://www.britannica.com/video/did-you-know-cryptocurrency-blockchain/-274583">explaining blockchain</a></strong> to people who did not ask. But language alone isn&#8217;t knowledge, <strong><a href="https://www.heretto.com/blog/structured-content">structured content</a></strong> alone isn&#8217;t meaning, and neither one automatically <strong><a href="https://unu.edu/article/never-assume-accuracy-artificial-intelligence-information-equals-truth">produces an answer a human being can trust</a></strong>, understand, or use without accidentally setting something expensive on fire.</p><p>That is why three unfashionably academic little &#8220;-ologies&#8221; matter more than ever: <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/what-are-ontologies?utm_campaign=post-expanded-share&amp;utm_medium=web">ontology</a></strong>, epistemology, and phenomenology.</p><p>Yes, I know. It sounds like somebody spilled a philosophy department onto a docs team. Stay with me.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!OgpH!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!OgpH!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!OgpH!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/a7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic&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;:342229,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/191763789?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic&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_!OgpH!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!OgpH!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa7e2c832-c6ef-4a5b-8978-b7454c607998_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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 are not decorative words for LinkedIn people who own too many blazers. These are concepts technical writers need to understand if they want to remain relevant in an AI-powered documentation world. More than that, they are the difference between being seen as someone who &#8220;writes help content&#8221; and someone who makes AI-delivered knowledge accurate, useful, and safe.</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/why-structured-content-alone-is-not">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[May 2026 Educational Webinars]]></title><description><![CDATA[The Content Wrangler hosts roughly 100 one-hour web presentations and talk shows each year and maintains an archive of over 800 shows available free-of-charge]]></description><link>https://www.thecontentwrangler.com/p/may-2026-educational-webinars</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/may-2026-educational-webinars</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 17 Apr 2026 15:15:46 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!42Xj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png"/><content:encoded><![CDATA[<p>The Content Wrangler <strong><a href="https://www.brighttalk.com/channel/9273">webinar channel</a></strong> is serving up another strong slate of one-hour educational events for technical writers and other information development professionals who want help making sense of where content strategy, technical communication, AI, structured content, metadata, localization, and knowledge management are headed next. </p><p>The lineup features an impressive range of experts, including <strong><a href="https://www.linkedin.com/in/sharonvburton/">Sharon Burton</a></strong>, <strong><a href="https://www.linkedin.com/in/singlesourceror/">Rob Hanna</a></strong>, <strong><a href="https://www.linkedin.com/in/ed-grzetich/">Ed Grzetich</a></strong>, <strong><a href="https://www.linkedin.com/in/rahelannebailie/">Rahel Bailie</a></strong>, <strong><a href="https://www.linkedin.com/in/sarahokeefe/">Sarah O&#8217;Keefe</a></strong>, <strong><a href="https://www.linkedin.com/in/katie-williamson-sebkhi-8787a85b/">Katie Williamson Sebkhi</a></strong>, <strong><a href="https://www.linkedin.com/in/susankraft-yorke/">Susan Kraft-Yorke</a></strong>, <strong><a href="https://www.linkedin.com/in/annie-malinda/">Anne Malinda</a></strong>, <strong><a href="https://www.linkedin.com/in/justyna-hietala/">Justyna Hietala</a></strong>, <strong><a href="https://www.linkedin.com/in/jasonmkaufman/">Jason Kaufman</a></strong>, <strong><a href="https://www.linkedin.com/in/torsten-machert-a0156219b/">Torsten Machert</a></strong>, <strong><a href="https://www.linkedin.com/in/wllewis/">Wendy Lewis</a></strong>, <strong><a href="https://www.linkedin.com/in/mark-pepper-a55a131/">Mark Pepper</a></strong>, and <strong><a href="https://www.linkedin.com/in/louisestengard/">Louise Stengard Kristiansen</a></strong>. </p><p>Together, these professionals explore everything from AI-powered retrieval and messaging misalignment to traceable knowledge, documentation quality, semantic layers, structured content, localization strategy, and the hidden role metadata plays in helping people find and trust the information they need.</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_!42Xj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!42Xj!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3ca6d19b-9dc8-4980-8347-e8b69accebbb_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;:2381656,&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/192983017?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_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_!42Xj!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!42Xj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3ca6d19b-9dc8-4980-8347-e8b69accebbb_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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>&#128467;&#65039; [May 6] The History of the History of Women in Technical Communication</h3><p>Hear untold stories that shaped technical communication as <strong><a href="https://www.linkedin.com/in/sharonvburton/">Sharon Burton</a></strong>, content strategist and editor, takes you behind the scenes of her new anthology, <strong><a href="https://www.amazon.com/Women-Technical-Communication-typewriters-touchscreens/dp/1937434915/ref=sr_1_1?adgrpid=186668573419&amp;dib=eyJ2IjoiMSJ9._OK04uVIvsIU7y69ZEVrjl5wdqavgg4L_Y3PecITcuo5r8mPxqi5t4IdYxbSTXfQQJCZife7n7pLWsS9E60MX-X4ZrSZNim1v8vYoL6wYuTydVcIKShh_k090KdVrVR33x6XuCw1Ymeu3l5d6SWaJbwHoqovMh8deHC-uAzsEsKW_-Bspp6ieam7_JpGi8X83IzK3aABStjd4Y9j1YPEYjtcwcG4e00qPsNLq6Rnz7g.AJEuQCtODbegqumutEvII1Q5_aXZjFz4DehELrC6vOE&amp;dib_tag=se&amp;hvadid=779674748105&amp;hvdev=c&amp;hvexpln=0&amp;hvlocphy=9031396&amp;hvnetw=g&amp;hvocijid=9716745535223659879--&amp;hvqmt=e&amp;hvrand=9716745535223659879&amp;hvtargid=kwd-2471203999093&amp;hydadcr=22593_13821245_8237&amp;keywords=women+in+technical+communication&amp;mcid=06c8310bfdf5385d94618e486da3ffbf&amp;qid=1775242090&amp;sr=8-1">Women in Technical Communication</a> </strong>(2026 <a href="https://www.xmlpress.net">XML Press</a>). Discover how this groundbreaking collection came to life&#8212;and why documenting our history matters now more than ever.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664435?utm_source=TheContentWranglerInc&amp;utm_medium=brighttalk&amp;utm_campaign=664435&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.brighttalk.com/webcast/9273/664435?utm_source=TheContentWranglerInc&amp;utm_medium=brighttalk&amp;utm_campaign=664435"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 7] It&#8217;s The Content, *#%#*$!</h3><p><strong><a href="https://www.linkedin.com/in/singlesourceror/">Rob Hanna</a></strong>, CEO and Co-Founder of <strong><a href="https://www.PrecisionContent.com">Precision Content</a></strong>, will dissect the critical role that source material plays in determining whether your AI delivers value or disappointment. Explore the real reasons behind &#8220;bad content in, bad content out&#8221; and discover practical steps you can take to ensure your AI-generated output meets expectations. You&#8217;ll gain actionable insights on how to identify weak points in your existing content pipeline and strategies for transforming flawed inputs into high-quality results.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665954?utm_source=TheContentWranglerInc&amp;utm_medium=brighttalk&amp;utm_campaign=665954&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.brighttalk.com/webcast/9273/665954?utm_source=TheContentWranglerInc&amp;utm_medium=brighttalk&amp;utm_campaign=665954"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 12] Why Documentation Format Matters More Than AI Model</h3><p>Join <strong><a href="https://www.linkedin.com/in/ed-grzetich/">Ed Grzetich</a></strong>, Technical Documentation Specialist, as he shares research from over 21,000 integration tests revealing a surprising insight: documentation format impacts AI-generated code quality more than which model you use. You&#8217;ll see why the wrong format can cause smaller models to fail completely, while optimized formats empower both advanced and basic AI tools to deliver better results.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664984?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664984?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 13] Conversational AI: The Cost of Ignoring Structured Content</h3><p><strong><a href="https://www.linkedin.com/in/rahelannebailie/">Rahel Bailie</a></strong>, Content Solutions Strategist at <strong><a href="https://www.content-seriously.com/">Content Seriously</a></strong>, and host <strong><a href="https://www.linkedin.com/in/sarahokeefe/">Sarah O&#8217;Keefe</a></strong>, Founder &amp; CEO of <strong><a href="https://www.Scriptorium.com">Scriptorium Publishing</a></strong>, examine how the intersection of structured content and conversational AI has evolved. They also discuss practical next steps that organizations can take to create a successful AI content strategy.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664432?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664432?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 13] How to Get Buy-In, Show Value, and Earn a Seat at the Table</h3><p>Discover practical strategies for influencing your team and stakeholders&#8212;even when you don&#8217;t have formal authority. <strong><a href="https://www.linkedin.com/in/katie-williamson-sebkhi-8787a85b/">Katie Williamson Sebkhi</a></strong><a href="https://www.linkedin.com/in/katie-williamson-sebkhi-8787a85b/">,</a> Director of UX Content Strategy at <strong><a href="https://www.cloudflare.com/">Cloudflare</a></strong>, will share proven tactics to help you get buy-in, demonstrate value early, and secure a seat at the table without resorting to endless explanations.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665873?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665873?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 14] A $3M Penalty: The Hidden Cost of Bad Technical Documentation</h3><p>In this session, <strong><a href="https://www.linkedin.com/in/susankraft-yorke/">Susan Kraft-Yorke</a></strong>, Information Architect at <strong><a href="https://www.linkedin.com/company/kraft-consulting-docs-as-assets/">Kraft Consulting</a></strong>, reveals how inconsistent document practices can quietly erode client trust, slash revenue, and undermine team productivity&#8212;even costing companies millions in preventable penalties. </p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664419?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664419?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 14] Scientific Communication for Technical Writers</h3><p><strong><a href="https://www.linkedin.com/in/annie-malinda/">Anne Malinda</a></strong>, QA Document Control Specialist at <strong><a href="https://encoded.com/">Encoded Therapeutics</a></strong>, will guide you through the shared foundations that unite these fields&#8212;clarity, accuracy, structured messaging, and ethical responsibility. Discover where science communicators and technical writers overlap, and pinpoint what truly sets them apart: audience and content, not ability. </p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664436?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664436?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 19] Struggles, Sins, Survival Strategies: The Secret Life of Tech Writers</h3><p>Join <strong><a href="https://www.linkedin.com/in/justyna-hietala/">Justyna Hietala</a></strong>, Senior Designer in Technical Documentation at <strong><a href="https://www.beamex.com/">Beamex</a></strong> Oy Ab, for an honest exploration into the frustrations, hidden challenges, and psychological hurdles that come with creating documentation. Step behind the scenes to examine why so many documentation tasks feel invisible&#8212;and why coping behaviors often emerge in response to relentless deadlines, shifting reviews, complex tools, and localization demands. Hear candid &#8220;confessions&#8221; from the trenches and learn how recognizing what you can control, influence, or choose helps reduce frustration and restore focus.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664416?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664416?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 19] Destroy Enterprise Knowledge Chaos for Hallucination-Free GenAI</h3><p>Join <strong><a href="https://www.linkedin.com/in/jasonmkaufman/">Jason Kaufman</a></strong>, CEO &amp; Co-Founder of <strong><a href="https://zaon.com/">Zaon Labs,</a></strong> as he reveals why documentation &#8212; not just model tuning &#8212; holds the key to trustworthy generative AI.<br>Explore how incomplete, conflicting, or outdated technical content forces AI systems to fabricate answers, propagate obsolete workflows, and confuse end-users. Learn practical methods for identifying documentation gaps, harmonizing information across platforms like SharePoint and wikis, and establishing update cycles that keep your knowledge base current and reliable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664868?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664868?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 20] How To Survive The Four Horsemen of the &#8220;AIpocalypse&#8221;</h3><p><strong><a href="https://www.linkedin.com/in/torsten-machert-a0156219b/">Torsten Machert</a></strong> (<a href="https://www.congree.com/en">Congree Language Technologies</a>) and <strong><a href="https://www.linkedin.com/in/sarahokeefe/">Sarah O&#8217;Keefe</a></strong> (<a href="https://www.scriptorium.com">Scriptorium Publishing</a>) reveal the four biggest threats undermining quality when you rely on GenAI for content creation, and explore actionable strategies to address these challenges so your output remains consistent, accurate, and unmistakably yours.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665561?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665561?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 21] The Semantic Layer: A Hidden Capability That Makes Data Useful</h3><p>Join <strong><a href="https://www.linkedin.com/in/wllewis/">Wendy Lewis</a></strong>, Knowledge Engineer at <strong><a href="https://www.ukg.com">UKG</a></strong> and <strong><a href="https://www.datatomato.net/">datatomato</a></strong>, as she unpacks the role of the semantic (or knowledge) layer in transforming scattered info into actionable insights. Explore what a semantic layer is, why it matters, and how it works to align language, reduce ambiguity, and connect teams across your organization.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/665791?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/665791?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 21] Best Practices For Tech Writers Moving To Structured Content</h3><p>Join <strong><a href="https://www.linkedin.com/in/mark-pepper-a55a131/">Mark Pepper</a></strong>, Principal Consultant at <strong><a href="https://crimsonsagesoftworks.com/">Crimson Sage Softworks Incorporated</a></strong>, as he demonstrates how to conduct effective content audits that reveal what you have &#8212; and what you need. Discover how to design a taxonomy tailored to your business goals and map it directly to metadata, ensuring your content is organized, discoverable, and ready for reuse.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664767?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664767?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><h3>&#128467;&#65039; [May 28] Setting Up a Localization Strategy For Technical Documentation</h3><p>Join <strong><a href="https://www.linkedin.com/in/louisestengard/">Louise Stengard Kristiansen</a></strong>, Globalization Strategist at ProStrategy | <strong><a href="https://www.houseoflocalization.com/">House of Localization</a></strong>, as she reveals why so many localization efforts fail before they even begin and how you can avoid common pitfalls. You&#8217;ll learn how to assess your current localization maturity, design effective workflows, select the right translation management system (TMS), and implement governance frameworks that support quality and consistency.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://www.brighttalk.com/webcast/9273/664977?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare&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.brighttalk.com/webcast/9273/664977?utm_source=brighttalk-sharing&amp;utm_medium=web&amp;utm_campaign=linkshare"><span>Register</span></a></p><div><hr></div><p></p><p></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>]]></content:encoded></item><item><title><![CDATA[What Claude Shannon Knew In 1950 That We’re Pretending Is New]]></title><description><![CDATA[AI didn&#8217;t arrive yesterday; it just changed its outfit]]></description><link>https://www.thecontentwrangler.com/p/what-claude-shannon-knew-in-1950</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-claude-shannon-knew-in-1950</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 16 Apr 2026 15:05:40 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!N021!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png"/><content:encoded><![CDATA[<p>Every era gets its <strong><a href="https://www.theamericanconsumer.org/2025/03/past-tech-panic-gives-context-for-modern-anxieties/">favorite tech panic</a></strong>. Ours, apparently, is watching a chatbot say something polished, half-right, and faintly dangerous, then acting as though civilization has been ambushed by a brand-new problem. But <strong><a href="https://www.newyorker.com/tech/annals-of-technology/claude-shannon-the-father-of-the-information-age-turns-1100100">Claude Shannon</a></strong> saw the outline of this mess in 1950, back when computers were still large enough to qualify as real estate.</p><p>In his paper, &#8220;<strong><a href="https://www.pi.infn.it/~carosi/chess/shannon.txt">Programming a Computer for Playing Chess</a></strong>,&#8221; Shannon wasn&#8217;t trying to build a novelty act for brainy cocktail parties. He chose chess because it forced a machine to face the sort of problem machines are facing now: too many possible moves, not enough time to calculate everything, and no choice but to make a judgment anyway.</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>That should sound familiar to anyone watching <strong><a href="https://originality.ai/blog/worst-google-ai-responses#">generative AI answer questions</a></strong> about our products, policies, processes, or software configuration with the calm confidence of a man giving directions while standing in the wrong city.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!N021!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!N021!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!N021!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!N021!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!N021!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!N021!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1536,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2967034,&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/193259311?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.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_!N021!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!N021!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!N021!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!N021!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F20ad225b-5be0-4db3-ad8b-e4a6a92da7da_1024x1536.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>&#8220;Tolerably Good&#8221; Was the Goal</h2><p>One of the most useful things Shannon did was lower the temperature. He didn&#8217;t say machines had to play perfect chess. He said they had to play <strong>&#8220;tolerably good&#8221;</strong> chess. </p><p><strong>He understood that perfect performance wasn&#8217;t realistic.</strong> The problem space was too large. The machines of the day couldn&#8217;t analyze every possible continuation. So the real challenge wasn&#8217;t <em>perfection</em>. It was <em>usefulness.</em> </p><blockquote><p><strong>Could the machine make choices that were good enough to hold up under normal conditions?</strong></p></blockquote><p>That&#8217;s still the question with AI now, even though people keep dressing it up in more expensive language. <strong>We don&#8217;t actually need AI to be magical.</strong> <strong>We need it to be useful</strong> without wandering off into fiction. We need it to stop sounding certain when it should be saying, &#8220;I&#8217;m not entirely sure, and frankly neither should you be.&#8221;</p><p>The trouble is that &#8220;good enough&#8221; means very different things to different people depending on the task. If AI drafts a mediocre summary of a meeting, nobody faints. If it gives our prospects or customers the wrong setup instruction, skips a prerequisite, or blends two different product versions into one smooth paragraph of nonsense, suddenly &#8220;tolerably good&#8221; starts looking like a phrase that should come with a lawyer.</p><blockquote><p><strong>Related:</strong> <a href="https://sustainabletechpartner.com/topics/ai/generative-ai-lawsuit-timeline/">Generative AI Lawsuits Timeline</a><strong> </strong><em>(updated weekly)</em></p></blockquote><h2>The Machine Doesn&#8217;t Know &#8212; It Guesses, Confidently</h2><p>Shannon understood something that <strong><a href="https://papers.ssrn.com/sol3/papers.cfm?abstract_id=5237414">people still resist</a></strong> because it ruins the fantasy. A machine doesn&#8217;t always arrive at the answer by knowing the answer. Often, it arrives there by <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/probabilistic-vs-deterministic-why?utm_campaign=post-expanded-share&amp;utm_medium=web">evaluating possibilities and choosing what seems best</a></strong><a href="https://open.substack.com/pub/thecontentwrangler/p/probabilistic-vs-deterministic-why?utm_campaign=post-expanded-share&amp;utm_medium=web"> </a>according to the signals it has.</p><p>Modern AI works pretty much the same way. It doesn&#8217;t know your product the way an experienced support agent knows it. It doesn&#8217;t understand your docs the way a careful reader does. It doesn&#8217;t stop, scratch its chin, and ask whether two similar procedures might apply to different user roles. It predicts. It estimates. It assembles a response that looks like the kind of thing a good answer would look like.</p><p>When the signals are strong, this can feel impressive. When the signals are weak, missing, or inconsistent, it still produces something. That&#8217;s where the trouble starts. The output may sound measured and complete, which is often the first sign you should worry.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!MVE3!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!MVE3!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!MVE3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c851edde-5d01-43e7-9c00-5fbc111aaf03_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;:3056248,&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/193259311?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_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_!MVE3!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!MVE3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc851edde-5d01-43e7-9c00-5fbc111aaf03_1536x1024.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Coherence Isn&#8217;t the Same Thing as Accuracy</h2><p><strong>People often treat fluent, easy-to-process language as a cue that something is true.</strong> Psychologists call this <strong>processing fluency</strong>, and a large body of research ties it to truth judgments. In a classic study, statements that were simply easier to read were more likely to be judged true. The authors&#8217; conclusion was blunt: &#8220;perceptual fluency affects judgments of truth.&#8221;<br><br>If the answer flows nicely, uses the correct nouns, and doesn&#8217;t visibly burst into flames, <strong><a href="https://www.sciencedirect.com/science/article/pii/S1053810099903860?utm_source=chatgpt.com">many assume the machine must have understood</a></strong> what it was talking about.</p><p>But Shannon pushes against that kind of wishful thinking. He knew the system would often rely on approximation. In chess, that means the machine makes a reasonable move without proving it&#8217;s the best move. In genAI, the machine doesn&#8217;t arrive at an answer by checking whether it&#8217;s true in the way a human expert might. It produces a response by predicting what a good answer is likely to <em>sound</em> like, one <strong><a href="https://thenewstack.io/what-is-an-llm-token-beginner-friendly-guide-for-developers/?utm_source=chatgpt.com">LLM token</a></strong> at a time. That&#8217;s why AI-generated output can read as polished, measured, and entirely sensible while still being wrong in ways that matter.</p><p>That distinction matters a lot for tech writers. A response can be coherent and still be useless. It can be elegant and still omit the thing that mattered most. It can sound like it belongs in the product manual while quietly steering the reader into a ditch.</p><p>That&#8217;s why the current conversation about AI so often feels silly. People keep asking whether the prose sounds natural. That&#8217;s the least interesting part. The dangerous part is that the prose sounds natural even when the reasoning underneath it is shaky enough to qualify as decorative.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!aetJ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!aetJ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!aetJ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/8a004a82-6f69-4421-9a82-e42b11608229_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;:3492576,&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/193259311?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_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_!aetJ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!aetJ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8a004a82-6f69-4421-9a82-e42b11608229_1536x1024.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>The Real Issue Isn&#8217;t Intelligence &#8212; It&#8217;s Signal Quality</h3><p>Shannon&#8217;s <strong><a href="https://www.computerhistory.org/chess/doc-431614f453dde/">chess-playing computer</a></strong> needed a way to judge <strong>positions </strong>&#8212;<strong> </strong><em>basically, how the board was set up at that moment</em> &#8212; when it couldn&#8217;t calculate everything. In other words, it needed signals that helped it decide what choices looked stronger, weaker, safer, riskier, more promising.</p><p>That should sound very familiar to tech writers working with <strong><a href="https://www.thecontentwrangler.com/p/why-technical-writers-must-evolve?utm_source=publication-search">structured content</a></strong>, <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/metadata-is-not-just-data-about-data?utm_campaign=post-expanded-share&amp;utm_medium=web">metadata</a></strong>, taxonomy, <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/what-are-ontologies?utm_campaign=post-expanded-share&amp;utm_medium=web">ontology</a></strong>, versioning, or workflow status. Because in modern AI systems, those are the <em>signals</em>.</p><p>They tell the model, or the retrieval layer feeding the model, what content applies to which audience, which version is current, which procedure belongs to which product version, which warnings matter, and which info has been reviewed and approved by someone who&#8217;d prefer not to be sued.</p><p>Without those signals, the machine doesn&#8217;t throw up its hands and refuse to answer. That would be far too responsible. It keeps going. It infers. It blends. It smooths over cumbersome gaps. It performs the digital equivalent of a person nodding along in a conversation they stopped understanding eight minutes ago.</p><p>That&#8217;s why weak content governance keeps showing up as an AI problem. It isn&#8217;t always an AI problem. Quite often it&#8217;s a problem with our content that AI exposes.</p><h2>Why Tech Writers Are Suddenly More Important</h2><p>This is where the tech writer&#8217;s job gets more interesting, and perhaps a bit more annoying. &#129324; It used to be enough for us to write clearly for humans. Homo sapiens are patient in ways machines aren&#8217;t. We notice contradictions, sense when context is missing, and when it is, we infer from surrounding material. We pause when something feels off.</p><p><strong>AI doesn&#8217;t do that.</strong> Nope. It doesn&#8217;t slow down because a sentence feels off. It doesn&#8217;t ask whether the <em>warning</em> in one document conflicts with <em>caution</em> advice in another. It doesn&#8217;t notice that the troubleshooting article applies only to Version 11 while the setup instructions were written for Version 9 and last updated when everyone still thought <strong><a href="https://barkoder.com/blog/30-shocking-qr-code-statistics-you-need-to-know-in-2025">QR codes</a></strong> were futuristic.</p><p>So now our job is larger. We have to <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/why-technical-writers-need-to-understand-2ca?utm_campaign=post-expanded-share&amp;utm_medium=web">make context more explicit</a></strong>, surface conditions, boundaries, prerequisites, exceptions, and applicability in our content. And, we have to help the system distinguish between general guidance and situation-specific instruction.</p><p>It&#8217;s <em>not glamorous</em>, but it <em>is</em> important. The machine can only work with what the content provides.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!EhVB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!EhVB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!EhVB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/849f3794-69e5-4266-b58e-b056df6b5d68_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;:3479869,&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/193259311?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_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_!EhVB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!EhVB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F849f3794-69e5-4266-b58e-b056df6b5d68_1536x1024.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>We&#8217;re Not Dealing With A New Problem</h2><p>The reason Shannon&#8217;s work still matters some 75+ years later is that he described the shape of the problem long before anyone had a chatbot to blame. A machine facing a large decision space can&#8217;t calculate everything. It has to use <strong><a href="https://bbroum.substack.com/p/generative-ai">approximations</a></strong> (see video below to learn more). The quality of its behavior depends on the quality of the signals guiding those approximations. That was true in 1950. It&#8217;s true now.</p><div class="native-video-embed" data-component-name="VideoPlaceholder" data-attrs="{&quot;mediaUploadId&quot;:&quot;d4db335b-42d0-44d1-b529-011ffc0355e6&quot;,&quot;duration&quot;:null}"></div><p>What changed is that the machine no longer sits quietly in the corner playing chess. Now it drafts documents, answers support questions, summarizes policy, and speaks to customers in complete sentences (increasingly through human-like interfaces called <strong><a href="https://www.d-id.com/resources/glossary/digital-avatar/">digital avatars</a></strong> or <strong><a href="https://virtualhumans.org/">virtual humans</a></strong>). That makes the underlying problem more visible, but it doesn&#8217;t make it new.</p><p>We keep pretending we&#8217;ve stumbled into some unprecedented crisis of machine unreliability. In truth, we&#8217;ve mostly put a friendly conversational interface on top of an old computational reality and then acted stunned when it behaved like a machine making approximations under constraint.</p><p>In fact, it may be useful for us to stop saying that AI systems hallucinate when <strong><a href="https://medium.com/@rlmaehlum/its-not-a-hallucination-it-s-a-gap-04bf1dfc4df6">they actually approximate</a></strong>.</p><p><strong>Claude Shannon would not be surprised. He might be amused, though. &#128518;</strong></p><h2>We Should Stop Pretending We Don&#8217;t Know</h2><p>If there&#8217;s a lesson here for us, it&#8217;s not that AI is broken or that machines are foolish or that prompts are the secret to salvation. It&#8217;s that reliability has always depended on bounded problems, explicit signals, and sensible expectations.</p><p>AI doesn&#8217;t need to be brilliant. It needs to be trustworthy within clear limits. That means the content behind it &#8212; our content &#8212;&nbsp;has to do more than read well. It has to signal what applies, what doesn&#8217;t, what changed, what matters, and what should never be blended into a paragraph just because the model found it statistically convenient.</p><p>Shannon knew that a machine making decisions under uncertainty would only ever be as good as the method guiding its choices. We&#8217;re still learning that lesson now, only with better branding and much more overconfidence. &#129312;</p><p></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[Introducing Claude (from Anthropic)]]></title><description><![CDATA[This video introduces Claude as more than a chatbot&#8212;it's an AI assistant designed to be your thinking partner]]></description><link>https://www.thecontentwrangler.com/p/introducing-claude-from-anthropic</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/introducing-claude-from-anthropic</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 14 Apr 2026 20:01:18 GMT</pubDate><enclosure length="0" type="audio/mpeg" url="https://api.substack.com/feed/podcast/194125121/e07ac1a4b7c5948a73b3d79b07066bdc.mp3"/><content:encoded><![CDATA[<p>Watch this short (90 second) video to start your journey learning what makes <strong><a href="https://claude.ai">Claude</a></strong> different from other AI tools. Discover how it can help you with a wide variety of tasks.</p><p>Once you&#8217;re ready to learn more about putting Claude to work for you, consider taking this free online course, <strong><a href="https://anthropic.skilljar.com/claude-101">Claude 101</a></strong>.</p>]]></content:encoded></item><item><title><![CDATA[Google Will Teach You To Write For AI, But Not How To Keep AI From Lying]]></title><description><![CDATA[Google&#8217;s tech writing courses improve clarity and structure, but they stop short of teaching the practices needed to make AI-generated answers accurate and reliable]]></description><link>https://www.thecontentwrangler.com/p/google-will-teach-you-to-write-for</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/google-will-teach-you-to-write-for</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 14 Apr 2026 15:30:36 GMT</pubDate><enclosure length="0" type="image/jpeg" url="https://substackcdn.com/image/fetch/$s_!7SNi!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic"/><content:encoded><![CDATA[<p>There&#8217;s something reassuring about Google offering free courses on tech writing. You can almost picture the outcome, right? Engineers take the course &#8212; and &#8220;Voila!&#8221; &#8212; less ambiguity; more clarity. Sentences become shorter, paragraphs stop wandering, and instructions begin to resemble actual instructions. </p><p>Their online <strong><a href="https://developers.google.com/tech-writing">courses</a></strong> walk through the fundamentals with clarity. They also include <strong><a href="https://developers.google.com/tech-writing/two/llms">advice</a></strong> on working with large language models (LLMs). If you follow their guidance, your writing will likely improve. Your docs should become easier to read; your intent harder to misinterpret.</p><p>It feels like progress. And it is. <strong>But only up to a point.</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_!7SNi!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!7SNi!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!7SNi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic&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;:290778,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!7SNi!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!7SNi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f548e7c-aab9-4eeb-a691-30afa3d09ea5_1536x1024.heic 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>The Subtle Shift No One Can Ignore</h2><p>Tech docs have a new reader. Not a person skimming for answers while jumping between online meetings (and while distracted by a steady stream of Slack notifications) but a system that retrieves, assembles, and delivers those answers on demand.</p><p><strong>The system does not read the way humans do.</strong> Instead, it predicts, reconstructs, and responds. It takes what you wrote and turns it into something else.</p><p>Google&#8217;s guidance helps us with that process. Clear sentences and logical and consistent content organization give the model something to work with. But clarity alone does not determine what the model produces.</p><p>That is where <em>the gap</em> begins.</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_!EvBQ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!EvBQ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!EvBQ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic&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;:335504,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!EvBQ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!EvBQ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F32013c4e-2a49-4236-93cc-8360a355648e_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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 The Model Fills In The Blanks</h2><p>Large language models are good at <strong><a href="https://cdn.openai.com/pdf/d04913be-3f6f-4d2b-b283-ff432ef4aaa5/why-language-models-hallucinate.pdf">producing language that sounds correct</a></strong>. They&#8217;re less reliable when the source material is incomplete or inconsistent.</p><p>Unlike humans, when context is missing, the model does not pause and ask us for clarification. Instead, it proceeds full steam ahead.</p><p>Researchers at Stanford University have <strong><a href="https://hai.stanford.edu/news/ai-hallucinations-arent-bugs-theyre-features">shown that models can generate citations that look real but do not exist</a></strong>. The titles and authors seem credible at first glance. The problem is the sources are fabricated, and far too often, completely detached from reality.</p><p>Other <strong><a href="https://arxiv.org/abs/2305.12138">research shows</a></strong> that LLMs can explain what code does <em>while missing why it was designed that way</em>, because the reasons why weren&#8217;t captured in the docs to begin with.</p><p><strong><a href="https://www.nytimes.com/2023/05/01/technology/ai-chatbots-hallucination.html">Reporting from The New York Times</a></strong> has identified cases where AI assistants combine outdated and current info into a single answer without signaling the conflict.</p><blockquote><p>These aren&#8217;t edge cases. They&#8217;re predictable outcomes. The model isn&#8217;t inventing problems. It&#8217;s exposing the gaps.</p></blockquote><h2>What Clear Writing Can And Cannot Do</h2><p>I think Google&#8217;s <strong><a href="https://developers.google.com/tech-writing/one/clear-sentences">guidance on clear sentences</a></strong> and <strong><a href="https://developers.google.com/tech-writing/one/organization">organizing content</a></strong> is fairly solid.</p><ul><li><p>Clarity reduces ambiguity &#9989;</p></li><li><p>Structure improves comprehension &#9989;</p></li></ul><p>We know these things are required to produce usable docs. But, they&#8217;re not enough if we&#8217;re hoping they&#8217;ll help us obtain reliable AI output.</p><p>A polished sentence may still lack context. A neatly structured page may still leave out key constraints. And a clear explanation may apply only to one version, audience, or configuration without ever saying so.</p><blockquote><p><strong>LLMs do not know what we meant to include,</strong> <strong>but didn&#8217;t.</strong> It only works with what we provide it.</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_!NWZk!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!NWZk!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!NWZk!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic&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;:259550,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!NWZk!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!NWZk!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3595ac6d-2eea-4e3e-87a6-fc997f5a2d02_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>The Context That Never Made It Into The Content</h2><p>This is where Google&#8217;s guidance starts to show its limits. The courses offered focus on <em>how to write</em>. They <strong>do not address</strong> <em>how to encode meaning in a way machines can reliably interpret</em>.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!umeP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!umeP!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!umeP!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!umeP!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!umeP!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!umeP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ebc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic&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;:289125,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!umeP!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!umeP!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!umeP!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!umeP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febc59114-86fe-48bc-b0a6-a24e4ed020bc_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Consider <strong>metadata</strong></h3><p>Google tells us to define our audience, but not to encode that audience in a way that our systems can recognize and act upon. </p><p>Without metadata, important differences between user roles, product versions, and situations stay hidden. The model may blend them together into one answer that sounds correct but doesn&#8217;t really fit any of them.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wQDx!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wQDx!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!wQDx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic&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;:405414,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!wQDx!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!wQDx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3954eccf-445f-462e-9912-ff118fd0a86d_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Consider <strong>taxonomy</strong></h3><p>Google encourages clear headings (a solid suggestion) but does not address <strong><a href="https://www.thelanguageoflocalization.com/2018/09/12/term-of-the-week-controlled-language/">controlled vocabulary</a></strong> or semantic consistency. </p><p>People usually know when different words are just different outfits on the same idea. Dog, pooch, hound, pup, mutt &#8212; no one needs a crisis counselor to sort that out. <strong><a href="https://www.readingrockets.org/topics/vocabulary/articles/using-context-clues-understand-word-meanings?utm_source=chatgpt.com">Context</a></strong> does the work. </p><p>LLMs <strong><a href="https://arxiv.org/abs/2309.12288">do not always manage that trick</a></strong> gracefully. Sometimes they treat minor wording changes as if the universe has shifted on its axis. Other times they blur important differences and act as though related terms all belong in one big semantic junk drawer.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Q37p!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Q37p!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Q37p!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic&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;:358906,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Q37p!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Q37p!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82ade276-a146-4c88-a6e9-29ca05c65fb5_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Consider <strong>provenance</strong></h3><p>Google says to review AI output, but it doesn&#8217;t explain how to check where the source content came from, whether it is still valid, or whether anyone approved it. Without that information, old or unverified content can show up next to current guidance with no warning that it may be risky.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!hfa4!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!hfa4!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!hfa4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic&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;:356819,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/heic&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/193071823?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!hfa4!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!hfa4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7e439649-6bde-433f-a542-2c328c7186a6_1536x1024.heic 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" 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"><g><title></title><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 tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><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"><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>Consider <strong>content models</strong></h3><p>Google discusses organization at the document level, but not structure at the semantic level. A content model defines what types of content exist, what components they contain, and how those components relate. Without it, content remains a collection of pages. With it, content becomes a system that supports consistent interpretation.</p><h2>A Familiar Scenario To Illustrate This Challenge</h2><p>Imagine a doc set that includes a setup guide that someone wrote two years ago, a troubleshooting article you updated yesterday, and a release note explaining that the old instructions no longer work after a recent update.</p><p>Individually, each doc is clear and well written. <strong>None of them share consistent metadata, terminology, or version context.</strong></p><p>Your user asks an AI assistant how to set up a feature. The assistant pulls info from all three documents and combines it into an answer that sounds clear and complete. <strong>But the answer is wrong for that user&#8217;s version, setup, or situation.</strong></p><p>The problem isn&#8217;t that one document was badly written. The problem is that the content didn&#8217;t include the structure, labels, and context the AI needed to tell what applied and what didn&#8217;t.</p><div><hr></div><blockquote><p><strong>Real-world example:</strong> [It] kept telling me that that I had to use this one <em>envar</em> to put the app in debug mode. <strong>But it wasn't working at all</strong>. So eventually I get around to looking deeper into it and it turns out that <strong>this method was used 2 versions prior</strong> to the current version. &#8212;&nbsp;<strong><a href="https://github.com/microsoft/vscode-copilot-release/issues/1244#issuecomment-2132296592">GITHub post</a></strong>  <a href="https://github.com/microsoft/vscode-copilot-release/issues/1244#top">Very outdated answers and wrong suggestions everywhere</a></p></blockquote><div><hr></div><h2>What Google Teaches Us &#8212; And What It Leaves for Us To Learn On Our Own</h2><p>Google&#8217;s courses establish a baseline. They teach writers to produce content that is clear, structured, and easier to process. That baseline matters. Without it, nothing else works. Period.</p><p>But it fails to address the factors that determine whether AI-generated answers are accurate, consistent, and trustworthy. Those factors include <em>structure beyond formatting</em>, <em>context beyond prose</em>, and <em>governance beyond editorial review</em>.</p><p>They include decisions about how meaning is represented, how relationships are defined, and how trust is established. That work is not covered in the courses.</p><h2>The Work That Now Defines Our Role</h2><p>We tech writers have always been responsible for clarity. Now we&#8217;re also responsible for context. That includes making intent explicit, encoding meaning in ways machines can interpret, and ensuring that our content can be trusted when it&#8217;s retrieved, combined, and delivered outside its original form.</p><p>This isn&#8217;t a shift away from writing. It&#8217;s an expansion of what our writing must accomplish.</p><p><strong>The sentence still matters. But the system that surrounds it matters more.</strong></p><h2>The Difference Between Readable Content And Trustworthy Content</h2><p>Google will help you write docs that AI can read. It won&#8217;t help you create docs that AI can trust. And as AI takes on a larger role in delivering answers, that distinction moves from academic to operational. Those of us that recognize this distinction will design content accordingly. The rest of us will continue to wonder why their docs sound right but behave unpredictably. &#129312;</p><p></p>]]></content:encoded></item></channel></rss>