<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0"><channel><title><![CDATA[The Content Wrangler: Tech Writing]]></title><description><![CDATA[Home to studies, best practices, lessons learned, interviews, articles, books, classes, and events of interest to technical writing professionals]]></description><link>https://www.thecontentwrangler.com/s/technical-documentation</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: Tech Writing</title><link>https://www.thecontentwrangler.com/s/technical-documentation</link></image><generator>Substack</generator><lastBuildDate>Sat, 23 May 2026 05:56:26 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[A Wiki Can Store Knowledge, But That Doesn’t Make It A Knowledge System]]></title><description><![CDATA[Governance matters, but so does tool category &#8212; and confusing collaboration with controlled content management is where many documentation teams get into trouble]]></description><link>https://www.thecontentwrangler.com/p/a-wiki-can-store-knowledge-but-that</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/a-wiki-can-store-knowledge-but-that</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 19 May 2026 15:31:48 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!zICw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>A reader named <strong>Byron</strong> (aka <strong><a href="https://substack.com/@thegrumpysociologist">The Grumpy Sociologist</a></strong>) left a <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/when-confluence-starts-groaning-a?r=8sej&amp;utm_campaign=comment-list-share-cta&amp;utm_medium=web&amp;comments=true&amp;commentId=257340777">thoughtful comment</a></strong> on my <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/when-confluence-starts-groaning-a?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">recent post</a></strong> about Confluence, wiki sprawl, and what happens when organizations start treating collaborative workspaces as if they were governed content systems.</p><p>His comment was fair &#8212; and also useful. The kind of useful that stings a little at first, which is often how useful arrives.</p><p><strong>I believe Byron&#8217;s main point was this:</strong> the symptoms I described are familiar to anyone who has watched a wiki mature, decay, multiply, contradict itself, and eventually become the place where institutional knowledge goes to develop several competing personalities.</p><p>Contradictory pages. Stale search results. Important information hiding in old Slack threads. Authoritative guidance living in three places, each one slightly different and all of them confident.</p><p>He agreed those problems are real. Where he pushed back was on <strong><a href="https://www.thecontentwrangler.com/p/when-confluence-starts-groaning-a">my diagnosis</a></strong>.</p><p>He argued that <strong><a href="https://open.substack.com/pub/thecontentwrangler/p/when-technical-documentation-rots?r=8sej&amp;utm_campaign=post-expanded-share&amp;utm_medium=web">wiki rot</a></strong> is not really a property of the tool. It&#8217;s a property of the organization (or lack thereof, as the case may be). Replace Confluence with a component content management system, a docs-as-code pipeline, or a shiny knowledge delivery platform, and a team without governance will still produce scattered, contradictory, half-maintained content.</p><p><strong>He&#8217;s right about that.</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_!zICw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!zICw!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!zICw!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!zICw!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!zICw!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!zICw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/cd098800-bca9-46e2-87f1-6608c4eed8b5_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;:2211085,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_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_!zICw!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!zICw!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!zICw!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!zICw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcd098800-bca9-46e2-87f1-6608c4eed8b5_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><p>A bad ownership model will damage any system. As will a missing review cadence, weak or non-existent taxonomy or a lack of discipline. Authoring incentives that reward speed over maintainability invite challenges, and software doesn&#8217;t fix organizational misbehavior &#8212; because tools don&#8216;t typically attend meetings, resolve accountability issues, or gently remind someone that copying the same warning into twenty-seven places is not a sustainable reuse strategy. It is a future incident report, at best.</p><p>That part of Byron&#8217;s critique lands.</p><p>But there&#8217;s another part of the argument that still matters, especially for tech writers. Governance matters. Culture matters. Ownership matters. But so too does tool category.</p><p>A <strong><a href="https://bloomfire.com/resources/what-is-a-wiki/">collaborative wiki</a></strong> is not the same thing as a component content management system (CCMS).</p><p>And pretending those two categories are interchangeable is one reason documentation teams end up disappointed.</p><h2>I Could&#8217;ve Been More Precise</h2><p>Byron also called out my use of &#8220;knowledge management system&#8221; to describe Confluence. He said that was sloppy. <strong>He&#8217;s right.</strong></p><p>I didn&#8217;t intend to say Confluence is a knowledge management system. What I meant is that many organizations use Confluence as though it were one.</p><p><strong>That distinction matters.</strong></p><p>Confluence is a collaborative wiki and team workspace. Atlassian describes it as &#8220;your team workspace for creating and sharing knowledge&#8221; and also markets it under wiki use cases as &#8220;The original Wiki.&#8221; Additionally, the company has a page that describes Confluence as <em>knowledge management software</em>, which helps explain why organizations often blur the categories in the first place.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!mCCL!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!mCCL!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 424w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 848w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 1272w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!mCCL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png" width="1456" height="1165" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1165,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:294724,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.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_!mCCL!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 424w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 848w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.png 1272w, https://substackcdn.com/image/fetch/$s_!mCCL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F82e6e4d9-61a1-4fdb-a6ba-e6f8d5563017_1860x1488.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">Atlassian uses the words &#8220;knowledge&#8221; in its <a href="https://www.atlassian.com/software/confluence/use-cases/wiki">marketing</a> and product information.</figcaption></figure></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!u6VB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!u6VB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 424w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 848w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 1272w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!u6VB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png" width="1456" height="1289" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1289,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:258516,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.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_!u6VB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 424w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 848w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.png 1272w, https://substackcdn.com/image/fetch/$s_!u6VB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6be01ccd-7f0a-4279-9096-c94183dd205b_1728x1530.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">Atlassian Confluence <a href="https://www.atlassian.com/software/confluence/use-cases/knowledge-management-software">&#8220;knowledge management&#8221; use case</a>.</figcaption></figure></div><div><hr></div><p>So yes, I should have said this more clearly: <strong>Confluence can support some knowledge management practices.</strong></p><p>That doesn&#8217;t make it the same category of tool as a purpose-built component content management system.</p><h2>The Problem Isn&#8217;t &#8216;Confluence Bad, CCMS Good&#8217;</h2><p>Let&#8217;s get the lazy argument out of the way. The problem is not &#8220;Confluence bad, CCMS good.&#8221;</p><p>A well-governed wiki may outperform a poorly governed CCMS. No argument from me. I&#8217;ve seen expensive systems become beautifully structured disasters because no one wanted to make hard decisions about ownership, authority, metadata, workflow, reuse, review, or retirement.</p><div class="callout-block" data-callout="true"><p><strong>A CCMS without governance can become an expensive structured mess.</strong></p></div><div class="callout-block" data-callout="true"><p><strong>But the reverse is also true: a wiki, even a well-governed one, does not automatically become a CCMS because people write good rules around it.</strong></p></div><p>That&#8217;s the point technical writers need to hold onto.</p><p>Governance determines whether the system succeeds.</p><p>The platform determines which governance model is practical, enforceable, scalable, and economically sustainable.</p><p>Those are not the same claim.</p><h2>A Wiki Usually Manages Pages &#8212; A CCMS Manages Content Components</h2><p>A collaborative wiki usually organizes content as pages. Teams create pages, edit them, and link them to other pages. They may also use the wiki to comment on pages, search them, and <em>sometimes</em> archive them if the organization using the wiki is unusually disciplined (or frightened by auditors).</p><p>That page-based model works well for many kinds of collaboration. It&#8217;s great for meeting notes, project planning, informal docs, lightweight processes, internal updates, and shared workspaces where the main goal is to get people contributing quickly.</p><p>But tech docs often requires different content models.</p><p>A component content management system manages content in smaller, structured, reusable units. Paligo describes a CCMS as software for &#8220;creating, managing, and publishing technical documentation through reusable content components,&#8221; where content is built from individual elements that can be assembled and reused across publications.</p><p>That difference is not academic. It changes what a system can do.</p><p>In a CCMS, a warning, prerequisite, troubleshooting step, safety statement, API parameter description, legal disclaimer, product specification, or reusable procedure can be managed as a component rather than as copied text scattered across a collection of hypertext-linked pages.</p><p>When the source component changes, the change can flow to every publication where that component appears. That&#8217;s not just &#8220;better governance.&#8221;</p><p>That&#8217;s a dramatically different technical capability.</p><h2>Transclusion Isn&#8217;t &#8216;Exactly&#8217; The Same Thing As Systematic Reuse</h2><p>This is where the conversation gets more interesting. Someone might say, quite reasonably: &#8220;But wikis can do reuse. They can <strong><a href="https://thelanguageoftechnicalcommunication.com/2016/09/06/term-of-the-week-transclusion/">transclude</a></strong> content.&#8221; That&#8217;s true.</p><p>Transclusion is a mechanism. It allows one piece of content to appear inside another piece of content by reference. The source content lives in one place, and other pages display or publish it as though it lives there too.</p><p>That&#8217;s useful. It is much better than copy and paste. It can reduce duplication. It can help teams maintain shared content more consistently.</p><p>In the book, <em><strong><a href="https://thelanguageoftechnicalcommunication.com">The Language of Technical Communication</a></strong></em>, Eliot Kimber explains that </p><div class="callout-block" data-callout="true"><p>&#8220;Systems that support transclusion also bring unavoidable complexity in terms of authoring effort, hyperlink management, configuration management, quality assurance of reused content, and so on. Tech writers need to understand the cost that comes with the power of transclusion so they can choose when to accept those costs. It is easy to transclude yourself into serious trouble. However, used correctly, transclusion enables more efficient authoring and management of information.&#8221;</p></div><p><strong>Transclusion is not exactly the same thing as systematic reuse.</strong></p><p>Ann Rockley&#8217;s concept of <strong><a href="https://www.rockley.com/articles/MEC_Chapter_2.pdf">systematic reuse</a></strong> is broader. In <em><strong><a href="https://www.managingenterprisecontent.com/">Managing Enterprise Content</a></strong></em>, Rockley distinguishes systematic reuse from opportunistic reuse. Systematic reuse is planned. </p><div class="callout-block" data-callout="true"><p>&#8220;It requires teams to identify reusable content, design it intentionally, manage it consistently, and deliver it where it is needed. The content management system helps insert the right reusable content in the right place.&#8221;</p></div><p>That distinction matters.</p><blockquote><p><strong>Transclusion asks:</strong> &#8220;Can I include this content over there?&#8221;</p></blockquote><blockquote><p><strong>Systematic reuse asks:</strong> &#8220;How do we design, govern, track, update, assemble, translate, and deliver reusable content across the entire content lifecycle?&#8221;</p></blockquote><p>Those are related ideas, but they are not identical.</p><p>A wiki with transclusion can include content by reference. A CCMS is usually built around systematic reuse as an operating model.</p><p>That means reusable components aren&#8217;t just snippets that appear in multiple places. They are <strong>governed units of content</strong> with structure, metadata, ownership, version control, lifecycle state, translation status, and publishing behavior.</p><p>For tech writers, that difference matters because reuse isn&#8217;t just a convenience. It&#8217;s a control strategy.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!n9Ku!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!n9Ku!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!n9Ku!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/e4424f51-5433-43ae-892f-59c6e2567c58_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;:2653878,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_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_!n9Ku!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!n9Ku!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4424f51-5433-43ae-892f-59c6e2567c58_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>Copy-and-Paste Reuse Isn&#8217;t Efficient Reuse</h2><p>This is one of the places where the wiki-versus-CCMS distinction becomes obvious.</p><p>In a wiki, reuse often happens through copying, linking, embedding, transcluding, or manually referencing another page. Depending on the wiki and configuration, teams may create clever reuse patterns. Some teams do this well.</p><p>But in many organizations, not so much. Reuse becomes copy-and-paste focused. Someone writes a warning in one place. Another writer copies it into a second procedure. A third person revises it for a different product. </p><p>Six months later, support asks which version is correct. Nobody knows. Someone says, &#8220;Check Slack.&#8221; A small bird flies into a window. &#129695;</p><p>A CCMS approaches reuse differently. It can track the source component, where that component is reused, which version appears in which publication, and what must be updated when the source changes.</p><p>That matters for documentation pros because we are rarely managing one page at a time. Typically, we&#8217;re managing content across products, versions, audiences, channels, languages, regions, and release cycles.</p><div class="callout-block" data-callout="true"><p><strong>A page-based workspace can help teams write. A component-based system can help teams govern content as an asset.</strong></p></div><p>Those are related activities, but they are not the same activity.</p><h2>Structure Isn&#8217;t Decoration</h2><p>Another difference is structured authoring. In a wiki, structure is often social. Teams agree to templates, labels, page hierarchies, naming conventions, and review practices. That can work, but much of the &#8212; <em>a-hem</em> &#8212; enforcement depends on human discipline.</p><p>In a CCMS, structure can be built into the authoring model. This means the system can enforce rules about what kind of information belongs where. A task can require steps. A concept can be kept separate from a procedure. A warning can use a defined structure. Metadata can be required before publication. Content can be validated before it goes downstream.</p><div class="callout-block" data-callout="true"><p><strong>That matters because structure is not decoration. Structure carries meaning.</strong></p></div><p>For tech writers, this is especially important in AI-enabled environments. When our content is ambiguous, inconsistent, duplicated, or poorly typed, AI systems have to infer what the content means. They have to guess whether something we typed is a concept, task, warning, exception, prerequisite, policy, release note, workaround, or obsolete instruction.</p><p>Sometimes the system guesses correctly. Sometimes it produces confident nonsense.</p><p>The more explicit the structure, the less the system has to infer. And the less it has to infer, the better chance we have of getting accurate, grounded answers.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!nBJL!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!nBJL!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!nBJL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3783f248-4cbf-403a-af5a-5b3c7068614c_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;:2322383,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_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_!nBJL!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!nBJL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3783f248-4cbf-403a-af5a-5b3c7068614c_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>Delivery Is Part Of System Design, Not An Afterthought</h2><p>Collaborative wikis are often strong at internal authoring and knowledge sharing. They help people easily create and find pages. They support quick collaboration, comments, permissions, search, and history.</p><p>Those are useful capabilities. But documentation often has to go further.</p><p>A CCMS is usually specifically designed not just to store content, but to publish it in multiple forms: help sites, PDFs, portals, knowledge bases, release packages, training materials, in-product help, support content, and other outputs.</p><p><strong>Related reading:</strong> Multi-channel publishing</p><p>That publishing model matters.</p><p>A tech docs team may need to deliver different versions of the same core content to different audiences. Administrators get one version. End users another. Partners get a slightly different version. Regulated markets need region-specific language. Enterprise customers need content for supported versions. Internal support teams may need additional troubleshooting details that should not appear in public documentation.</p><p>In a wiki, those variations often become separate pages, labels, manual conventions, or permission schemes.</p><p>In a CCMS, those variations can be managed through structured reuse, profiling, filtering, conditions, metadata, and publishing rules.</p><p>Again, this is not just governance. It&#8217;s governance made operational through system capability.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!YP2a!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!YP2a!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!YP2a!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/8efa41be-ce0c-454d-901f-8b758e0fba25_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;:2684363,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_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_!YP2a!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!YP2a!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8efa41be-ce0c-454d-901f-8b758e0fba25_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>Localization Exposes The Difference Quickly</h2><p>Localization is another place where the distinction becomes hard to ignore.</p><p>If your docs lives as pages, translation often happens at the page or document level. When content changes, you may need to determine what changed, where it changed, whether the change affects translated content, and which language versions need updates.</p><p>In a component-based system, the unit of management can be (and typically is)  smaller. If only one reusable component changed, only that component may need translation. If the same component appears in multiple outputs, the translation can be reused as well. That can significantly reduce cost, improve consistency, and shorten translation cycles.</p><p>It also reduces the risk of slightly different versions of the same instruction appearing across products, regions, or languages. For global tech docs teams, that&#8217;s not a minor feature &#8212; that&#8217;s operational infrastructure.</p><h2>Byron Is Right About The Organizational Problem</h2><p>The strongest part of Byron&#8217;s argument is the part documentation teams should not ignore: <strong>Documentation problems are often organizational problems.</strong></p><p>I agree. <br><br><strong>Tools cannot:</strong> </p><p>&#128073;&#127996; decide who owns a procedure<br>&#128073;&#127996;  decide when content becomes obsolete<br>&#128073;&#127996;  force product managers to stop treating documentation as a release-day garnish<br>&#128073;&#127996;  create a culture that rewards maintainability, clarity, and reuse</p><p>If an organization doesn&#8217;t value documentation governance, a CCMS won&#8217;t save it. Neither will docs-as-code or an AI chatbot with a soothing interface and a suspiciously cheerful answer to everything.</p><p>Doc teams need ownership models and review cadence. They need taxonomy and metadata discipline. and rules that govern content throughout its lifecycle. And, they  need to put in place incentives that reward reuse and maintenance, not just new content production.</p><p>That is the foundation. Byron is right to insist on it.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!PbRx!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!PbRx!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!PbRx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c9780fd0-f585-4454-a4c0-fe5fcacac540_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;:2723208,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_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_!PbRx!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!PbRx!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc9780fd0-f585-4454-a4c0-fe5fcacac540_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>But Tool Category Still Matters</h2><p>Where I differ from Byron is that I don&#8217;t think tool category is secondary to the point of irrelevance. Platforms shape what&#8217;s easy, what&#8217;s difficult, what&#8217;s enforceable, and what is likely to happen under pressure.</p><p><strong>And pressure is where documentation systems reveal themselves.</strong></p><p>&#128073;&#127996; When the release is late, do writers reuse approved content or copy and paste from the nearest page?<br>&#128073;&#127996; When support finds an error, can the team update one source component or hunt down every duplicate?<br>&#128073;&#127996; When legal changes a required statement, can the team trace every place it appears?<br>&#128073;&#127996; When a product has three supported versions, can the team publish version-specific content without maintaining three separate page forests?<br>&#128073;&#127996; When AI retrieves content to answer a customer question, can it tell which content is current, authoritative, audience-appropriate, and product-specific?</p><p><strong>Governance defines the desired behavior. </strong>The system determines how much effort it takes to behave that way. That&#8217;s why tool category matters.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!spmV!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!spmV!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!spmV!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!spmV!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!spmV!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!spmV!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/6fb57ddb-ecdf-4ddc-803e-5229297f61c3_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;:2425217,&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/198321316?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_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_!spmV!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!spmV!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!spmV!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!spmV!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6fb57ddb-ecdf-4ddc-803e-5229297f61c3_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>Hopefully, A Better Way To State The Argument</h2><p>After reading Byron&#8217;s comment, I&#8217;d restate my argument this way: </p><div class="callout-block" data-callout="true"><p><strong>The problem is not that Confluence causes documentation chaos. The problem is that many organizations use collaborative wikis as if they were something they aren&#8217;t &#8212;  governed content supply chains.</strong></p></div><p>Then they act surprised &#128561; when those systems cannot provide the same control, reuse, traceability, lifecycle management, localization support, and multi-channel publishing capabilities as systems built for those purposes.</p><p>Confluence can be a good fit for small teams, internal collaboration, project knowledge, lightweight documentation, and shared workspaces. A self-hosted wiki may also be a good fit for organizations with the engineering capacity to maintain it, customize it, secure it, and govern it properly. </p><p>Byron is right to point out that SaaS platforms bring real costs, including per-seat pricing, vendor roadmap dependency, migration complexity, and data control concerns. Those tradeoffs deserve serious discussion. But none of that changes the underlying distinction.</p><p>A collaborative wiki and a CCMS are different categories of tools. One is primarily optimized for collaborative knowledge creation and sharing. The other is designed to manage structured, reusable, governed content components through complex creation, review, translation, versioning, and publishing workflows.</p><p>You can govern a wiki well. You can also govern a CCMS badly. And, you can use transclusion in a wiki and still not have a systematic content reuse strategy you can depend on. &#129312;</p><h2></h2><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[So You Want To Go Freelance? Let’s Talk About What That Actually Looks Like]]></title><description><![CDATA[A clear-eyed look at freelancing that replaces the &#8220;be our own boss&#8221; fantasy with the messy, unpredictable reality tech writers must understand before going solo]]></description><link>https://www.thecontentwrangler.com/p/so-you-want-to-go-freelance-lets</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/so-you-want-to-go-freelance-lets</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 12 May 2026 11:30:45 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!ZxHU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>There&#8217;s a certain fantasy floating around about self-employment. We picture ourselves sipping coffee, rejecting meetings, and finally doing &#8220;real work&#8221; without someone Slacking us every seven minutes.</p><p>And then reality shows up, sits down across from us, and quietly explains that we&#8217;ve just become our own finance department, sales team, IT support desk, and emotional support animal.</p><p><strong><a href="https://lapope.com/who-i-am/">Lauren Pope</a></strong>&#8217;s post &#8212; <em><a href="https://lapope.com/2026/04/06/what-being-self-employed-in-content-really-looks-like/?utm_source=chatgpt.com">What being self-employed in content really looks like</a></em><strong> </strong>&#8212;<strong> </strong>pulls back the curtain on what self-employment in content actually looks like &#8212; not the LinkedIn version, the <em>real</em> one. For tech writers flirting with the idea of going solo, there are some lessons here you. Read these before you dramatically quit your job.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ZxHU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ZxHU!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ZxHU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/22d6e67e-badb-4293-97bf-8f0f0a990c3a_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;:161988,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_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_!ZxHU!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!ZxHU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F22d6e67e-badb-4293-97bf-8f0f0a990c3a_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>Lesson 1: Your Income Is Not Your Income</h2><p>Freelance math is not normal math. We might invoice what looks like a comfortable annual income, but we&#8217;ll take home roughly half after taxes, expenses, and the need to survive slow periods.</p><p>Also, no one is quietly contributing to our retirement while we sleep, either. That&#8217;s now our job. Along with insurance. And software subscription costs that multiply like rabbits when we&#8217;re not paying attention.</p><blockquote><p><strong>Translation for tech writers: </strong>That shiny day rate you&#8217;re imagining? Cut it in half before planning your new life as a financially stable rebel.</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_!DeZ9!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!DeZ9!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!DeZ9!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_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;:174610,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_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_!DeZ9!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!DeZ9!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8e253abd-2fb2-442a-bd9c-7c9c9ebeb4a3_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>Lesson 2: You Don&#8217;t Have <em>Clients</em>, You Have a Portfolio of Risk</h2><p>You&#8217;ll rarely have one steady stream of work. More often, you&#8217;ll be juggling two or three projects at a time, trying to balance focus with income stability.</p><p>Too few clients? You panic.<br>Too many clients? You do bad work and still panic.</p><p>And the kind of deep, strategic work many tech writers aspire to &#8212; content models, governance, structured content &#8212; requires long stretches of uninterrupted thinking. That doesn&#8217;t pair well with a calendar that looks like a game of Tetris.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!V7m7!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!V7m7!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!V7m7!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/84139e7c-71be-4e22-b15e-b6d582c2d962_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;:157412,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_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_!V7m7!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!V7m7!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F84139e7c-71be-4e22-b15e-b6d582c2d962_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>Lesson 3: Work Comes From People, Not Platforms</h2><p>Forget the fantasy of &#8220;I&#8217;ll just hang out a shingle and clients will appear.&#8221; </p><p>Ha! Not so much. </p><p><strong>Most work comes from:</strong></p><ul><li><p>People who already know us</p></li><li><p>People who&#8217;ve worked with us</p></li><li><p>People who&#8217;ve read our stuff or who we&#8217;ve otherwise engaged</p></li></ul><p>Word of mouth and reputation do most of the heavy lifting. Cold outreach? Advertising? Optional &#8212; <em>and often ineffective</em> depending on our niche.</p><blockquote><p><strong>Translation for tech writers: </strong>Our content isn&#8217;t just docs anymore. It&#8217;s marketing. Every blog post, webinar, or conference talk is quietly auditioning for our next client.</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_!ACWB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ACWB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ACWB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_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;:170471,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_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_!ACWB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!ACWB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cbfcb60-9f7b-4fa4-8a30-5789736a2aa4_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>Lesson 4: The Market Doesn&#8217;t Care About Your Timing</h2><p>We can be well-intentioned and do everything &#8220;right&#8221; and still have a bad year.</p><p>Budgets shrink. Strategy cycles end. Work dries up. We get sick. A project goes sideways and takes our sanity with it.</p><p>And here&#8217;s the fun part: when things go wrong, it feels personal. Because there&#8217;s no company to blame. It&#8217;s just us, staring at our insufficient pipeline of upcoming work.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!8rIn!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!8rIn!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!8rIn!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_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;:152763,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_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_!8rIn!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!8rIn!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1e8c7c92-ea15-41e7-a5bf-506bdf9ba217_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>Lesson 5: You Must Specialize</h2><p>Pope&#8217;s work leans heavily into content strategy, even though she still offers related services. That&#8217;s not an accident &#8212; it&#8217;s survival.</p><p>Clients don&#8217;t buy &#8220;a technical writer.&#8221; They buy someone who solves a very specific problem.</p><p><strong>Translation for tech writers:</strong><br>&#8220;Writes clear documentation&#8221; is not a niche. &#8220;Designs scalable content models for API platforms&#8221; is getting closer.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!26LP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!26LP!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!26LP!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!26LP!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!26LP!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!26LP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d147df31-589a-4f7b-98bf-85781e0cff3a_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;:166401,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_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_!26LP!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!26LP!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!26LP!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!26LP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd147df31-589a-4f7b-98bf-85781e0cff3a_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>Lesson 6: Pricing Is Part Courage, Part Therapy</h2><p>Most freelancers undercharge. Especially early on. My advice? Charge as much as you can without feeling physically ill &#8212; and then maybe a little more. </p><p>But don&#8217;t be delusional. Benchmark against peers. Understand the market. Then push yourself anyway.</p><p>It&#8217;s a struggle for many of us starting out to avoid allowing personal <strong><a href="https://academic.oup.com/jcr/pages/behavioral_pricing_in_jcr?utm_source=chatgpt.com">price sensitivity</a></strong> to impact our feelings about our worth. Sometimes, freelancers I&#8217;ve mentored undervalue their expertise because what they <em><strong>think</strong></em> they should charge <em><strong>sounds expensive</strong></em>, so they opt to <em><strong>charge less</strong></em> thinking this is how they will get the gig (by not charging too much &#8212; whatever that is). </p><p>If we don&#8217;t price your time and talents wisely, we&#8217;ll quietly build a business that looks busy but pays like a hobby.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Q3C2!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Q3C2!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Q3C2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/e9279d62-7992-4fe0-8a3b-1a9893283048_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;:194535,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_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_!Q3C2!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!Q3C2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe9279d62-7992-4fe0-8a3b-1a9893283048_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>Lesson 7: You&#8217;re Not Escaping Work &#8212; You&#8217;re Redefining It</h2><p>Self-employment isn&#8217;t less work. It&#8217;s different work. You&#8217;re still writing, designing, structuring, and solving problems.<br><br><strong>But now you&#8217;re also:</strong></p><ul><li><p>Managing cash flow</p></li><li><p>Finding clients</p></li><li><p>Negotiating contracts</p></li><li><p>Deciding what work to take (and what to walk away from)</p></li></ul><p>The upside? We get to shape our careers around our values, interests, and make decisions that don&#8217;t overwhelm our tolerance for nonsense.</p><p>The downside? We have to shape it. No one else is coming to do that for us. </p><h2>What This Means For Tech Writers</h2><p>Thinking about going freelance? Here&#8217;s the quiet truth:</p><p>We&#8217;re not just becoming an independent writer. We&#8217;re becoming a small business that also happens to produce content.</p><p><strong>And the skills that will matter most aren&#8217;t just:</strong></p><ul><li><p>writing clearly</p></li><li><p>structuring information</p></li><li><p>managing content systems</p></li></ul><p><strong>Instead, they&#8217;re:</strong></p><ul><li><p>positioning our expertise</p></li><li><p>building relationships</p></li><li><p>managing uncertainty</p></li><li><p>differentiating ourselves from the competitions</p></li><li><p>pricing our value</p></li><li><p>managing work-life balance</p></li></ul><p>In other words, the work doesn&#8217;t get easier. It gets broader.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!-bVw!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!-bVw!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!-bVw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f61f8ecd-9c97-4809-a8b6-e420cb023562_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;:283546,&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/195279046?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_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_!-bVw!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!-bVw!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff61f8ecd-9c97-4809-a8b6-e420cb023562_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 Takeaway For Tech Writers</h2><p>Self-employment can absolutely give us the career we wish existed. But it will also expose every weak spot in how we think about money, value, visibility, and resilience.</p><p>Which is why posts like this matter. They replace the unrealistic fantasy we conjure up ourselves with something far more useful: <strong>A map that says, &#8220;Yes, we can do this. But here&#8217;s what it actually costs.&#8221;</strong> &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[When Confluence Starts Groaning: A Practical Checklist For Knowing It’s Time To Upgrade Your Internal Docs Stack]]></title><description><![CDATA[At some point, your startup wiki stops being helpful and starts being a liability &#8212; the tricky part is noticing before it quietly wrecks everything]]></description><link>https://www.thecontentwrangler.com/p/when-confluence-starts-groaning-a</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/when-confluence-starts-groaning-a</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 11 May 2026 15:31:06 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!z77H!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>You go &#128064; looking for a simple answer. Not a philosophical one. Not a &#8220;let&#8217;s align on strategy&#8221; answer. Just a plain, factual, &#8220;how does this feature work?&#8221; kind of answer.</p><p>You search your internal docs in Attlassian Confluence and get six results. Three are outdated. One contradicts another. One links to a Slack thread from 2022 where someone named &#8220;Dan (Contractor)&#8221; says, &#8220;I think this is how it works?&#8221; The last one looks promising (until you realize it describes a feature your company quietly killed last quarter.)</p><p>So you do what everyone does. You ask for help in Slack.</p><p>Five people respond. Two disagree. One says, &#8220;Let me check.&#8221; Another drops a link&#8230; to one of the six pages you already read &#8212; the same one you linked to in your Slack query.</p><p>And just like that, your documentation system has completed its transformation from &#8220;source of truth&#8221; to &#8220;suggestion box.&#8221;</p><p><strong>This didn&#8217;t happen overnight. It never does.</strong></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!z77H!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!z77H!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!z77H!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!z77H!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!z77H!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!z77H!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/a2d248d0-f809-49da-a114-48ba383d52cf_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;:2310884,&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/195284264?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_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_!z77H!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!z77H!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!z77H!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!z77H!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa2d248d0-f809-49da-a114-48ba383d52cf_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>Why Confluence Worked (Until It Didn&#8217;t)</h2><p>Let&#8217;s be fair. Confluence didn&#8217;t betray us. It did exactly what we needed at the time.</p><p>It&#8217;s fast and somewhat flexible. It lets pretty much anyone write nearly anything, almost anywhere, at any time. In the early days, that felt like progress. We were moving quickly, building features, hiring people, figuring things out as we went. Structure felts like a luxury we couldn&#8217;t afford back then.</p><p><strong>And for a while, that was true.</strong></p><p>When our team was small and our content footprint was manageable, we didn&#8217;t need governance (or so we thought); we needed speed. We wanted a place to put things so they wouldn&#8217;t disappear into someone&#8217;s brain forever.</p><p>Confluence was great at that. Right up until it wasn&#8217;t.</p><h2>The Moment Things Start to Slip</h2><p>The shift here is subtle. We didn&#8217;t wake up one morning and declare, &#8220;Our documentation system has failed us.&#8221; Instead, we started noticing small things.</p><p>People stopped trusting the docs. They began double-checking everything. They asked questions they shouldn&#8217;t have to ask and when they figure out what they needed to know they often created new pages in the wiki instead of updating old ones because it&#8217;s faster than figuring out what&#8217;s already there.</p><p>Our content was growing, but its usefulness wasn't.</p><p>That&#8217;s the moment our &#8220;flexible&#8221; system becomes an unmanageable one.</p><h2>The Signs You&#8217;ve Outgrown Your Setup</h2><p>What should we do, you ask? Well, first, we don&#8217;t need a formal audit to know something&#8217;s off. We just need to pay attention to the patterns that can help us identify the obstacles and challenges our internal documentation content hairball introduces.</p><h3>Do we know if there&#8217;s a problem?</h3><p>We can often easily see the signs of internal documentation problems. Docs contradict themselves. There&#8217;s no clear source of truth, just a collection of &#8220;maybe, probably correct&#8221; answers. Pages linger long after they&#8217;ve expired, like leftovers no one wants to claim. Subject matter experts rewrite entire sections instead of updating them, because it&#8217;s easier than untangling what came before.</p><p>Search becomes a scavenger hunt. Results are plentiful but not helpful. Navigation reflects how our org chart is structured, not how people actually think. Users bypass documentation entirely and head straight to Slack, where answers are <em>fresher</em> &#8212; even if they&#8217;re not <em>better</em>.</p><p>Scaling becomes awkward. The same information appears in multiple places because reuse isn&#8217;t a thing our team has made an effort to make systematic &#8212; it&#8217;s a wish, at best. Localization feels like a fantasy. Publishing content to different channels involves copying, pasting, and a quiet prayer that nothing breaks.</p><p>Governance, if it exists at all, is mostly implied. Anyone can publish anything. Review cycles are optional. Versioning is&#8230; optimistic.</p><p>And then there&#8217;s the AI problem.</p><p>We point a generative AI tool at our documentation, expecting magic. &#129668; What we get instead is a confident stream of half-truths, contradictions, and occasionally inspired fiction. The AI isn&#8217;t broken. It&#8217;s doing exactly what it&#8217;s supposed to do &#8212; summarizing messy and ungoverned input into equally messy output.</p><p>Turns out, chaos in equals chaos out.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Ozbh!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Ozbh!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Ozbh!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ba96b643-e851-44bd-83e5-cc8b542dbdea_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;:2188981,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/195284264?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!Ozbh!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!Ozbh!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba96b643-e851-44bd-83e5-cc8b542dbdea_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>What It&#8217;s Actually Costing You</h2><p>Here&#8217;s the part no one likes to say out loud: we&#8217;re already paying for this problem.</p><p>We&#8217;re paying in time; every minute someone spends searching, second-guessing, or rewriting content that already exists somewhere. We&#8217;re also paying in expensive onboarding delays, as new hires struggle to separate fact from folklore.</p><p>And, we&#8217;re paying in support costs, because people can&#8217;t find answers that should be obvious. We&#8217;re also paying in product friction, when users don&#8217;t understand what we&#8217;ve built well enough to use it or explain it to others.</p><p>And if we&#8217;re exploring AI (who isnt?), we&#8217;re paying there, too; unreliable content doesn&#8217;t magically become reliable when we run it through a language model. It just becomes faster at being wrong.</p><h2>So What Are &#8220;Professional Tools,&#8221; Really?</h2><p>This is where people get nervous, because it starts to sound like a tooling conversation. And tooling conversations have a reputation for turning into expensive shopping trips.</p><p><strong>But this isn&#8217;t about buying something shiny. It&#8217;s about capabilities.</strong></p><p>At a certain scale, we need content that&#8217;s structured, not just written. Modular, not monolithic. Reusable, not endlessly duplicated.</p><p>We need workflows that ensure our content is reviewed, approved, and maintained; not just created and forgotten.</p><p>We need metadata and taxonomy so our information can be found, filtered, and delivered in ways that make sense to our users.</p><p>We need the ability to publish the same content across multiple channels without copying and pasting it into oblivion. And increasingly, we need content that machines can understand (not just humans) so AI systems can retrieve accurate, grounded answers instead of improvising and getting it wrong.</p><p>There are different ways to get there. Component content management systems. Docs-as-code environments. Knowledge delivery platforms.</p><p>The specifics matter less than the outcome.</p><p>We&#8217;re moving from &#8220;a place where we store information&#8221; to &#8220;a system that manages, governs, and delivers knowledge.&#8221;</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!H32Q!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!H32Q!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!H32Q!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/44300e28-e901-4550-b51a-d724e7a87c94_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;:2259490,&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/195284264?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_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_!H32Q!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!H32Q!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F44300e28-e901-4550-b51a-d724e7a87c94_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>Making The Business Case Without Sounding Like We Just Want New Toys</h2><p>If we walk into a meeting and say, &#8220;Our team needs a new documentation platform,&#8221; we&#8217;ll get exactly the reaction we deserve. &#129764; Blank stares. Budget concerns. Someone asking if this can wait until next year (or the year after).</p><p><strong>So don&#8217;t pitch a tool.</strong></p><p>Start with evidence. Show the broken pages. The conflicting information. The Slack threads that exist because the docs failed.</p><p>Then translate that into cost. Not abstract cost &#8212; real cost &#128176;. Time lost. Support tickets created. Delays introduced.</p><p>Tie it to business goals like faster onboarding, improved customer experience, more reliable AI initiatives, or reduced support burden.</p><p>And for the love of all things sensible, don&#8217;t propose a massive migration as the opening move. Start small by piloting something. Prove that a better approach produces better outcomes by making the problem clearly visible to those who should care before trying to sell the solution.</p><h2>A Quick Reality Check About Migration</h2><p>Let&#8217;s not pretend this part is fun. Migration means cleanup and confronting the fact that some of our content shouldn&#8217;t make the journey. It means defining governance (where none existed before) and asking people to change how they work.</p><p>The reality here: There will likely be resistance. There&#8217;ll be moments when you question your life choices. But there&#8217;s also an <em>upside</em>.</p><p>Migration is the one time we&#8217;re allowed &#8212; expected, even &#8212; to fix what&#8217;s broken instead of working around it. And we don&#8217;t have to fix everything at once. In fact, we shouldn&#8217;t.</p><h2>One Question to Ask Yourself Before You Do Anything Else</h2><p>If our entire team disappeared tomorrow, would someone else be able to rely on our documentation to run the business? Not &#8220;eventually figure it out.&#8221; Not &#8220;after asking a few questions.&#8221; Actually rely on it.</p><p>If the honest answer involves Slack, guesswork, or crossing your fingers, well &#8230; there&#8217;s work to do.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!xSEg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!xSEg!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!xSEg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/99ed7f92-0ac1-41d3-a393-0ab4d14daf05_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;:2303807,&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/195284264?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_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_!xSEg!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!xSEg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F99ed7f92-0ac1-41d3-a393-0ab4d14daf05_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>The Quiet Shift No One Talks About</h2><p>At some point, documentation stops being a side effect of building a product and becomes part of the product itself (whether anyone recognizes that or not). When that happens, the tools we use (and the way we manage content) stop being a convenience decision. They become a <em>business</em> decision.</p><p>And that&#8217;s usually right around the time Confluence starts to groan.</p><p>Not because it&#8217;s broken &#8212; but because we&#8217;ve asked it to do a job it was never designed to handle at scale. </p><p>We don&#8217;t notice the shift right away. We just feel the friction and watch as the extra minutes spent searching tick by. We also feel the second-guessing and the quiet erosion of trust, until one day, the system we relied on to keep us aligned is the thing slowing us down.</p><p><strong>At that point, the question isn&#8217;t whether we need to change. It&#8217;s how much longer we&#8217;re willing to pay for not changing.</strong> &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[The Song About Tech Writing That Nobody Asked For (But Honestly, We Needed)]]></title><description><![CDATA[A laid-back reggae track that somehow captures the chaos, craft, and quiet wins of technical writing better than most status meetings ever will]]></description><link>https://www.thecontentwrangler.com/p/the-song-about-tech-writing-that</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-song-about-tech-writing-that</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Sat, 09 May 2026 15:31:10 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!_QTU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>There&#8217;s a specific kind of exhaustion tech writers understand &#8212; the kind where you fix everything and nobody notices&#8230; which is exactly the point.</p><p>Now imagine that feeling set to reggae.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!_QTU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!_QTU!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!_QTU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/9b545b3c-ca6e-4d02-b49c-a70bf82feec2_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;:399486,&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/196691697?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_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_!_QTU!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!_QTU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9b545b3c-ca6e-4d02-b49c-a70bf82feec2_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><em>&#8220;<strong><a href="https://suno.com/song/81b4a618-0862-40b3-a35c-73d368b1516b?sh=qTpA5A6B7xhVWTDn&amp;fbclid=IwY2xjawRoY4RleHRuA2FlbQIxMQBicmlkETFEM1VmaGlZc0xKcmwybTJHc3J0YwZhcHBfaWQQMjIyMDM5MTc4ODIwMDg5MgABHuCmNe7r5rx2oZdicwCdaDqPGldtpEsHei4ZN5qymjZEiodZx9k7BJbvENyS_aem_wGK9pad0gB7uf18R4P021g">I Feel Your Pain</a></strong>&#8221;</em> by <strong><a href="https://www.linkedin.com/in/tmaldous/">Thomas Aldous</a></strong> (assisted by AI) is basically your workday with a beat. Deadlines shifting, tools changing, &#8220;quick updates&#8221; multiplying like rabbits &#8212; it&#8217;s all there. And somehow, it&#8217;s both <em>funny</em> and <em>a little too accurate</em>.</p><p>The line that lands hardest?</p><blockquote><p><strong>&#8220;Nobody sees the little saves&#8230;&#8221;</strong></p></blockquote><p>That&#8217;s the job. Quiet fixes. Invisible wins. Preventing chaos no one realizes almost happened.</p><div class="native-audio-embed" data-component-name="AudioPlaceholder" data-attrs="{&quot;label&quot;:null,&quot;mediaUploadId&quot;:&quot;c9f56734-62ba-4849-a103-6beaf2296267&quot;,&quot;duration&quot;:219.63756,&quot;downloadable&quot;:false,&quot;isEditorNode&quot;:true}"></div><h6><em>                                                                 &#8220;<strong><a href="https://suno.com/song/81b4a618-0862-40b3-a35c-73d368b1516b?sh=qTpA5A6B7xhVWTDn&amp;fbclid=IwY2xjawRoY4RleHRuA2FlbQIxMQBicmlkETFEM1VmaGlZc0xKcmwybTJHc3J0YwZhcHBfaWQQMjIyMDM5MTc4ODIwMDg5MgABHuCmNe7r5rx2oZdicwCdaDqPGldtpEsHei4ZN5qymjZEiodZx9k7BJbvENyS_aem_wGK9pad0gB7uf18R4P021g">I Feel Your Pain</a></strong>&#8221;</em> by <strong><a href="https://www.linkedin.com/in/tmaldous/">Thomas Aldous</a><br><br></strong></h6><p><strong>Then it sneaks in something bigger:</strong> we were structuring knowledge, modeling systems, and making meaning long before AI showed up. That hasn&#8217;t changed.</p><p>AI can generate words. It still depends on people who know what those words <em>mean</em>.</p><p>So yeah &#8212; give it a listen. If nothing else, it&#8217;s three minutes of feeling seen&#8230; without having to update a screenshot. &#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[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 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" length="0" type="image/jpeg"/><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 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 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" length="0" type="image/jpeg"/><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[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 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" length="0" type="image/jpeg"/><content:encoded><![CDATA[<h2>The Meeting Everyone Pretends Is Fine</h2><p>There is a 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[The Importance of Domain Knowledge and Structured Authoring Skills for Tech Writers]]></title><description><![CDATA[Jack Molisani and Scott Abel discuss what employers actually look for when hiring tech writers]]></description><link>https://www.thecontentwrangler.com/p/the-importance-of-domain-knowledge</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-importance-of-domain-knowledge</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 13 Apr 2026 15:30:54 GMT</pubDate><enclosure url="https://api.substack.com/feed/podcast/192319452/cd306522802b29cfe62bddc9ded3d1e9.mp3" length="0" type="audio/mpeg"/><content:encoded><![CDATA[<p>On March 5, 2026, Scott Abel, The Content Wrangler, sat down to chat with <strong><a href="https://www.linkedin.com/in/jackmolisani/">Jack Molisani</a></strong>, President of <strong><a href="https://prospringstaffing.com">ProSpring Technical Staffing</a></strong>, about the insights from the <em>2026 Technical Documentation Staffing Survey</em>. The data reveals how documentation leaders and hiring managers are navigating workforce dynamics in a rapidly evolving landscape.</p><p><strong>&#9654;&#65039; <a href="https://www.brighttalk.com/webcast/9273/663417">Watch</a></strong> the entire interview (60 minutes, on-demand).</p>]]></content:encoded></item><item><title><![CDATA[The Silent Hero of Coding: Why Developers Need Technical Documentation More Than They Think]]></title><description><![CDATA[Developers Can't Code Correctly Without It &#8212; We Should Thank Technical Writers for That]]></description><link>https://www.thecontentwrangler.com/p/the-silent-hero-of-coding-why-developers</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-silent-hero-of-coding-why-developers</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 06 Apr 2026 15:30:13 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!TDP1!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>It&#8217;s a truth universally acknowledged by every developer worth their salt: &#8220;You can never have too many resources when learning to code.&#8221; But here&#8217;s the kicker&#8212;of all the resources they use, the most indispensable is often the one they don&#8217;t praise enough: technical documentation. It&#8217;s like the water in the swimming pool that the lifeguard never mentions until you&#8217;re drowning.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!VbUf!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!VbUf!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!VbUf!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_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;:3189435,&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/192256459?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_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_!VbUf!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 424w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 848w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_1024x1536.png 1272w, https://substackcdn.com/image/fetch/$s_!VbUf!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd4306e2f-7da5-4fa9-ad5e-e75d1a3a690d_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><h3>The Underdog of Learning Resources</h3><p>The <strong><a href="https://survey.stackoverflow.co/2025/developers#profile">2025 Developer Survey</a></strong> paints an interesting picture. You&#8217;ve got your standard array of learning tools &#8212; Stack Overflow, blogs, online courses, and of course, videos. But lurking quietly in the background, capturing the attention of a staggering 68% of respondents, is technical documentation. <strong>It&#8217;s the often underappreciated rock star in a world obsessed with quick fixes and instant gratification.</strong></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p>Let&#8217;s break it down. Of the 33,454 developers who were polled (76% of them being the true &#8220;professional&#8221; variety and an additional 15% falling into the aspirational or adjacent developer category) there was a strong consensus. <strong>You need technical documentation to learn how to code.</strong> Let that sink in. </p><p>It&#8217;s clear we tech writers are holding the reins of knowledge, quietly helping software developers avoid the chaos of poorly understood libraries and buggy frameworks.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!TDP1!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!TDP1!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!TDP1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/cfbcbb64-49eb-4669-b969-27a41b35e0b5_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;:2338390,&quot;alt&quot;:&quot;&quot;,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/192256459?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" title="" srcset="https://substackcdn.com/image/fetch/$s_!TDP1!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!TDP1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcfbcbb64-49eb-4669-b969-27a41b35e0b5_1536x1024.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><h3>The Developer&#8217;s Best Friend: Technical Documentation</h3><p>Now, we all know that developers have a way of loving their code more than they love life itself. &#128518; Still, these same developers (mostly aged between 25 and 44) are relying on our docs to make sense of their tools, libraries, and frameworks. There&#8217;s a good reason why a significant 68% of survey respondents preferred it over other resources. It&#8217;s simple. <em><strong>It works</strong></em><strong>.</strong></p><p>While <strong><a href="https://stackoverflow.com/">Stack Overflow</a></strong> answers might solve an immediate issue, they don&#8217;t explain <em>why</em> things work the way they do (and even when they do, there&#8217;s no guarantee it'&#8216;s accurate). Enter technical documentation (<strong>the unsung hero of the coding world</strong>). Developers, especially those with less than 10 years under their belts, might not be able to remember every edge case for every function call, but the doc we produce help them <em>get it</em> when it matters most. </p><p>It&#8217;s the difference between frantically Googling &#8220;why does my program crash every time I try to run it?&#8221; and confidently consulting well-organized reference material that tells you what you&#8217;re doing wrong and how to fix it. It&#8217;s like the difference between using a map and wandering aimlessly.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Mpmu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Mpmu!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Mpmu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/bb5428a2-290f-4946-855b-4b3f59c3ace6_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;:2900550,&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/192256459?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_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_!Mpmu!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!Mpmu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb5428a2-290f-4946-855b-4b3f59c3ace6_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>Why Documentation Is the Bedrock of Success</h3><p>Okay, I&#8217;ll admit that documentation isn&#8217;t exactly the glamorous, party-loving cousin of a slick YouTube tutorial or a rapid-fire Stack Overflow answer, but it is where foundational knowledge lives. For most developers, especially those in the 35% who have been coding for fewer than 10 years, learning to code with solid documentation means building a robust, scalable understanding that no quick fix or trendy blog post can replace.</p><h3>The Case for Appreciating Technical Writers</h3><p>So, dear tech writers, it&#8217;s time we stand tall and claim our rightful spot at the table of essential resources. Developers might use other tools for a quick fix, but when it&#8217;s time to dive deep into understanding and mastering a framework, they&#8217;re coming to us. Documentation isn&#8217;t just a reference; it&#8217;s the bedrock of their continuing success.</p><p><strong>And to all the developers reading this:</strong> Next time you&#8217;re diving into a technical topic, remember that the person behind those docs aren&#8217;t just throwing a bunch of words into a file. They&#8217;re saving your proverbial butt one detailed, well-organized, thoroughly tested section at a time. And in a world where most things come with a &#8220;don&#8217;t ask, just Google it&#8221; disclaimer, isn&#8217;t that worth a little appreciation? &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[What Is Phenomenology (And Why Do Tech Writers Need To Understand It)?]]></title><description><![CDATA[Tech writers must understand the user&#8217;s lived experience, not just the system&#8217;s logic, to create docs people can actually follow]]></description><link>https://www.thecontentwrangler.com/p/what-is-phenomenology-and-why-do</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-phenomenology-and-why-do</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Thu, 02 Apr 2026 00:02:52 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!mFoQ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p><strong>Phenomenology</strong> is the study of lived experience. It asks what something feels like from the point of view of the person experiencing it. Not in a melodramatic &#8220;tell me about your journey&#8221; sort of way, but in a practical sense: <strong>What does the world look like to the user as they move through it? What do they notice, assume, misunderstand, fear, overlook, or need?</strong></p><p>That should sound familiar, because tech writers are supposed to care about exactly those things &#8212;&nbsp;and more.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!mFoQ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!mFoQ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!mFoQ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/fcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_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;:374686,&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/192908712?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_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_!mFoQ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!mFoQ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffcac500c-6b7a-4bea-9c05-1fa2c9e0a91e_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>A system may be logically designed. A workflow may be technically correct. A product team may insist the interface is &#8220;clear.&#8221; Meanwhile, the user is staring at a screen wondering whether clicking <strong>Save</strong> will publish the document, overwrite the document, summon legal, or end civilization as we know it. Phenomenology asks us to take that user experience seriously.</p><p>We need phenomenology because documentation is not just about describing how a system works from the inside. It is about helping someone navigate how that system appears from the outside, in real conditions, with limited context, imperfect memory, and a growing suspicion that every button has been named by a committee with boundary issues.</p><p>This matters because users do not experience products as architecture diagrams. They experience them as moments: confusion, hesitation, recovery, success, error, relief. Good documentation meets them there. It anticipates where they are likely to get lost, what they are likely to misread, and what they need in order to move forward with confidence.</p><p>In practical terms, phenomenology reminds us to pay attention to the user&#8217;s point of view, not just the system&#8217;s logic. It encourages us to write for the reality of use, not the fantasy of design. And that is important, because a procedure is only &#8220;clear&#8221; if it is clear to the person trying to follow it while three deadlines, two warnings, and one expired permission token are breathing down their neck.</p><p>Good documentation does not just explain the product. It respects the experience of using it. That is why phenomenology matters. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[What Is Epistemology (And Why Do Tech Writers Need To Understand It)?]]></title><description><![CDATA[How tech writers evaluate truth, trust, evidence, and authority before turning claims into docs users can rely on]]></description><link>https://www.thecontentwrangler.com/p/what-is-epistemology-and-why-do-tech</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-epistemology-and-why-do-tech</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 01 Apr 2026 23:51:33 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!aHd8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p><strong>Epistemology</strong> is the study of how we know what we know. It asks annoying but useful questions like: What counts as knowledge? What makes something true? How do we know a claim is reliable? When should we trust a source, a process, a person, or a system?</p><p>That may sound like philosophy-class material best left to people wearing scarves and speaking in paragraphs no one asked for. But tech writers deal with epistemology all the time.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!aHd8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!aHd8!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!aHd8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/356619d6-193b-476b-818f-cdda64548ad7_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;:253239,&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/192907960?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_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_!aHd8!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!aHd8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F356619d6-193b-476b-818f-cdda64548ad7_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>Every time we ask a subject matter expert to verify a procedure, question whether two sources conflict, decide which version of the truth belongs in the manual, or try to separate official guidance from tribal folklore, we&#8217;re doing <em>epistemic work</em>. We&#8217;re not just writing things down; we&#8217;re evaluating claims, testing evidence, identifying authority, and deciding what the reader should be able to trust.</p><p>That matters even more now that AI systems increasingly consume and remix documentation. If the source content is vague, inconsistent, poorly governed, or based on undocumented assumptions, the machine may produce fluent nonsense with the confidence of a man explaining wine in a restaurant. <strong>Epistemology helps writers think more clearly about provenance, evidence, certainty, and trust.</strong></p><p>In practical terms, tech writers need epistemology because documentation is not just about expressing knowledge. It is about deciding what knowledge deserves to be expressed, how firmly it can be stated, and what supports the claim. In other words, good documentation does not just tell users what is true. It helps ensure the truth has not been assembled from guesswork, vibes, and somebody&#8217;s half-remembered Slack message.</p><p>A strong documentation practice is, in part, a disciplined way of knowing. That is why epistemology belongs in the conversation. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[Why Technical Writers Should Read "Women in Technical Communication"]]></title><description><![CDATA[From typewriters to touchscreens, Sharon Burton has collected a history of experiences written by the women who did the work]]></description><link>https://www.thecontentwrangler.com/p/why-technical-writers-should-read</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/why-technical-writers-should-read</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 11 Mar 2026 19:39:36 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!BTTd!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Technical communication sometimes behaves as if it sprang fully formed from the forehead of Silicon Valley sometime around the invention of the <em>help file</em>. It did not. It was built over decades by people doing the work, adapting to change, and figuring things out long before someone slapped the word &#8220;innovation&#8221; on a conference slide.</p><p>That is why <em><strong><a href="https://xmlpress.net/publications/women-in-tech-comm/">Women in Technical Communication: From Typewriters to Touchscreens: a history by the women who did the work</a></strong></em>, edited by <strong><a href="https://www.linkedin.com/in/sharonvburton/">Sharon Burton</a></strong>, deserves a place on every technical writer&#8217;s reading list.</p><p>This anthology brings together firsthand stories from women who helped shape the profession across more than fifty years of change. From typewriters to PCs to smartphones, these contributors did not merely observe the field evolving. They built careers in it, influenced it, and in many cases helped define it. Which is more than can be said for the occasional modern pundit who has been in the field for eleven minutes and is already announcing its complete reinvention. &#128518;</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!BTTd!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!BTTd!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 424w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 848w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!BTTd!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg" width="728" height="348.8543689320388" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:false,&quot;imageSize&quot;:&quot;normal&quot;,&quot;height&quot;:691,&quot;width&quot;:1442,&quot;resizeWidth&quot;:728,&quot;bytes&quot;:190976,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/jpeg&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/190643749?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F91d4d778-063c-413d-a3ff-e3affe133f45_1920x1080.heic&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:&quot;center&quot;,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!BTTd!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 424w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 848w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!BTTd!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1cea4dc9-08f1-44a2-b7c9-a255bc19280d_1442x691.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><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>What makes this book valuable is that it preserves the voices of the women who did the work</h2><p>Not the sanitized corporate version. Not the after-the-fact summary. Their own words. Their own experiences. Their own accounts of building careers, leading change, and making space for themselves in workplaces that were not always eager to make room.</p><p>Technical communicators document everything except their own history. We preserve processes, systems, and product knowledge with almost religious devotion, but somehow leave the story of our own profession sitting unlabeled in a cardboard box. This book helps fix that.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://xmlpress.net/2026/03/02/women-in-technical-communication/&quot;,&quot;text&quot;:&quot;Buy The Book!&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://xmlpress.net/2026/03/02/women-in-technical-communication/"><span>Buy The Book!</span></a></p><p>It also offers perspective at exactly the right time! As tech writers wrestle with AI, automation, and yet another round of people insisting the profession must now become something entirely new, this anthology reminds us that change is not new. Reinvention is not new. The need to adapt without losing the plot is not new.</p><p>Newer technical writers should read this book to understand the roots of the profession. Experienced practitioners should read it for recognition and context. Leaders should read it because professions are built by people over time, not by tools, hype, or somebody&#8217;s aggressively branded framework.</p><p>If you care about technical communication as a discipline, not just a job title, buy this book. Read it because the field needs memory. Read it because the women who helped build it deserve to be heard. Read it because a profession that forgets its own history is doomed to keep rediscovering itself like a man who loses his glasses while wearing them.</p><p><em><strong><a href="https://xmlpress.net/2026/03/02/women-in-technical-communication/">Women in Technical Communication</a></strong></em>, edited by Sharon Burton, is published by <strong><a href="https://www.XMLPress.com">XML Press</a></strong>. <strong>Release date:</strong> March 30, 2026. <strong>Paperback:</strong> US $45.95. <strong>Ebook:</strong> US $29.95.</p><h2>Contributors List</h2><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Ajsm!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Ajsm!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 424w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 848w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 1272w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Ajsm!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic" width="1452" height="1068" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1068,&quot;width&quot;:1452,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:75222,&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/190643749?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.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_!Ajsm!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 424w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 848w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.heic 1272w, https://substackcdn.com/image/fetch/$s_!Ajsm!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4257ade9-a244-412f-a725-16d65c5696f8_1452x1068.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><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Zhvp!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Zhvp!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 424w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 848w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 1272w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Zhvp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic" width="1414" height="994" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:994,&quot;width&quot;:1414,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:58311,&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/190643749?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.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_!Zhvp!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 424w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 848w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.heic 1272w, https://substackcdn.com/image/fetch/$s_!Zhvp!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F636d0693-0029-4099-ad3a-e1e4a72a567f_1414x994.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><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[What Are Ontologies?]]></title><description><![CDATA[Discover why ontologies matter to technical writers]]></description><link>https://www.thecontentwrangler.com/p/what-are-ontologies</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-are-ontologies</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 03 Feb 2026 20:48:50 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!AVWt!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>In the documentation field, technical communicators often use words like <em>taxonomy</em>, <em>metadata</em>, <em>controlled vocabulary</em>, and <em>knowledge graph</em> interchangeably. They are not the same thing.</p><p>An <a href="https://en.wikipedia.org/wiki/Ontology_(information_science)">ontology</a> sits above all of them.</p><p>If AI systems are now reading, interpreting, and speaking on behalf of our documentation, understanding what an ontology is&#8212;and what it is not&#8212;becomes essential.</p><h2>A Plain-Language Definition of Ontology</h2><p>In the context of technical documentation:</p><blockquote><p><strong>An ontology is a formal model that defines what things exist in our domain, what they mean, and how they are allowed to relate to one another.</strong></p></blockquote><p>It does not store content. It does not store prose. It defines <strong>meaning and rules</strong>.</p><h2>Why &#8220;Meaning&#8221; Matters More Than Ever</h2><p>Traditional doc systems assume a human reader. Humans infer meaning from context, tolerate inconsistency, and notice when something feels &#8220;off&#8221;. </p><p>AI systems do none of that reliably. They need meaning to be <strong>explicit</strong>, not implied; exactly what an ontology provides.</p><h2>What An Ontology Actually Contains</h2><p>In technical documentation, an ontology typically defines four things.</p><h3>1. Concepts</h3><p>The <em>things</em> that exist in your product and documentation universe.</p><p><strong>Examples:</strong></p><ul><li><p>Product</p></li><li><p>Product version</p></li><li><p>Feature</p></li><li><p>Component</p></li><li><p>Task</p></li><li><p>Configuration</p></li><li><p>Warning</p></li><li><p>Error message</p></li><li><p>API endpoint</p></li><li><p>User role</p></li></ul><blockquote><p>An ontology answers: <strong>&#8220;What kinds of things are we allowed to talk about?&#8221;</strong></p></blockquote><h3>2. Relationships</h3><p>How those concepts connect to each other.</p><p><strong>Examples:</strong></p><ul><li><p><em>Feature</em> <strong>is part of</strong> <em>Product</em></p></li><li><p><em>Task</em> <strong>configures</strong> <em>Feature</em></p></li><li><p><em>Warning</em> <strong>applies to</strong> <em>Task</em></p></li><li><p><em>Feature</em> <strong>is deprecated in</strong> <em>Version</em></p></li></ul><blockquote><p>An ontology answers: <strong>&#8220;How are these things allowed to relate?&#8221;</strong></p></blockquote><h3>3. Constraints</h3><p>Rules that prevent invalid combinations.</p><p><strong>Examples:</strong></p><ul><li><p>This feature only applies to certain product versions</p></li><li><p>This task is only valid for admin users</p></li><li><p>This configuration is incompatible with another feature</p></li><li><p>This warning must appear whenever a specific condition exists</p></li></ul><blockquote><p>An ontology answers: <strong>&#8220;What must never be combined or inferred incorrectly?&#8221;</strong></p></blockquote><h3>4. Terminology control</h3><p>Shared understanding of language.</p><p><strong>Examples:</strong></p><ul><li><p>Preferred terms vs. synonyms</p></li><li><p>Deprecated terms</p></li><li><p>Acronyms and expansions</p></li></ul><blockquote><p>An ontology answers: <strong>&#8220;When we say a word, what do we mean&#8212;and what do we not mean?&#8221;</strong></p></blockquote><h2>Ontology vs. Taxonomy vs. Metadata</h2><p>These are related, but not interchangeable.</p><h3>Taxonomy</h3><p>A taxonomy organizes things into hierarchies.</p><p><strong>Example:</strong></p><ul><li><p>Product</p><ul><li><p>Feature</p><ul><li><p>Sub-feature</p></li></ul></li></ul></li></ul><blockquote><p>Taxonomies answer: <strong>&#8220;How do we group things?&#8221;</strong></p></blockquote><h3>Metadata</h3><p>Metadata describes individual content objects.</p><p><strong>Example:</strong></p><ul><li><p>Product = X</p></li><li><p>Version = 4.2</p></li><li><p>Audience = Admin</p></li></ul><blockquote><p>Metadata answers: <strong>&#8220;What attributes does this piece of content have?&#8221;</strong></p></blockquote><h3>Ontology</h3><p>An ontology defines the <strong>rules behind both</strong>.</p><p><strong>It answers:</strong></p><ul><li><p>What counts as a Product?</p></li><li><p>What is the difference between a Feature and a Configuration?</p></li><li><p>Can a Task apply to multiple Products?</p></li><li><p>When is something invalid, deprecated, or incompatible?</p></li></ul><p><strong>Without an ontology:</strong></p><ul><li><p>Taxonomies drift</p></li><li><p>Metadata becomes inconsistent</p></li><li><p>AI systems guess</p></li></ul><h2>Why Ontologies Matter Specifically For Technical Documentation</h2><h3>1. They prevent concept drift</h3><p>Over time, teams start using the same word to mean different things.</p><p><strong>Ontologies force alignment:</strong></p><ul><li><p>A feature is not a task</p></li><li><p>A task is not a concept</p></li><li><p>A version boundary is real, not optional</p></li></ul><p>This clarity improves both human comprehension and AI accuracy.</p><h3>2. They enable trustworthy AI answers</h3><p>AI systems that rely on documentation increasingly use semantic retrieval and generation.</p><p><strong>Without an ontology:</strong></p><ul><li><p>AI retrieves text that <em>sounds</em> relevant</p></li><li><p>Answers may combine incompatible concepts</p></li></ul><p><strong>With an ontology:</strong></p><ul><li><p>AI retrieves content that is <strong>conceptually valid</strong></p></li><li><p>Constraints prevent nonsense answers</p></li></ul><p>This is the foundation of ontology-grounded RAG.</p><h3>3. They elevate the role of technical writers</h3><p>Ontologies surface a truth many organizations ignore:</p><blockquote><p>Documentation is not just content. It is a knowledge system.</p></blockquote><p><strong>Technical writers are uniquely qualified to:</strong></p><ul><li><p>Define concepts clearly</p></li><li><p>Establish boundaries and intent</p></li><li><p>Model relationships humans understand intuitively</p></li></ul><p>Ontologies make that expertise visible and strategic.</p><blockquote><p>See also: <strong>What Is Ontology-Grounded Retrieval-Augmented Generation?</strong></p></blockquote><h2>What An Ontology Is Not</h2><p><strong>An ontology is not:</strong></p><ul><li><p>A style guide</p></li><li><p>A glossary (though it may reference one)</p></li><li><p>A CMS configuration</p></li><li><p>A single diagram created once and forgotten</p></li></ul><p><strong>An ontology is a</strong> <strong>living semantic contract</strong> <strong>between:</strong></p><ul><li><p>Content</p></li><li><p>Tools</p></li><li><p>AI systems</p></li><li><p>Humans</p></li></ul><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!AVWt!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!AVWt!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!AVWt!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ca5c7575-676b-45df-a15f-f4257423eb07_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;:405199,&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/186733517?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_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_!AVWt!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!AVWt!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fca5c7575-676b-45df-a15f-f4257423eb07_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 Do You Need An Ontology?</h2><p><strong>You especially need an ontology if:</strong></p><ul><li><p>Your products are modular or platform-based</p></li><li><p>You support multiple versions simultaneously</p></li><li><p>You are building or buying AI assistants</p></li><li><p>Your documentation feeds chatbots or copilots</p></li><li><p>Consistency and trust matter</p></li></ul><p>If AI is now the front door to our documentation, an ontology is the lock that keeps the wrong answers out.</p><h2>The Takeaway For Tech Writers</h2><p>In technical documentation, an ontology answers the hardest question of all:</p><p>&#8220;What does this actually mean &#8212; and what is it allowed to mean?&#8221;</p><p><strong>Writers who help define and govern ontologies shape how:</strong></p><ul><li><p>Content is retrieved</p></li><li><p>Answers are generated</p></li><li><p>Products are understood</p></li></ul><p>As AI becomes the voice of your documentation, ontologies decide whether that voice is informed &#8212; or improvising.</p><p>And improvisation is not a strategy. &#129312;</p><p></p><p></p><p></p>]]></content:encoded></item><item><title><![CDATA[What Makes a Topic a Good DITA Topic?]]></title><description><![CDATA[A DITA topic is effective when it meets specific criteria, this post makes the criteria clear]]></description><link>https://www.thecontentwrangler.com/p/what-makes-a-topic-a-good-dita-topic</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-makes-a-topic-a-good-dita-topic</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 03 Feb 2026 20:44:26 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!adm_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>A <a href="https://docs.oasis-open.org/dita/v1.0/langspec/topic.html">DITA topic</a> is a small, self-contained unit of information designed to answer <strong>one specific user need</strong>. Not a chapter. Not a page. Not a long narrative. One purpose. One job.</p><p>If you remember nothing else, remember this: <strong>DITA topics exist to do </strong><em><strong>one thing</strong></em><strong> for </strong><em><strong>one user intent </strong></em><strong>&#8212; clearly, consistently, and reuse-ready. </strong>&#129488;</p><p>That single idea explains why DITA works so well at scale and why it behaves differently from traditional document-centric authoring.</p><blockquote><p><strong>See also:</strong> <a href="https://open.substack.com/pub/thecontentwrangler/p/what-is-the-darwin-information-typing?utm_campaign=post-expanded-share&amp;utm_medium=web">What is the Darwin Information Typing Architecture (DITA)?</a></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_!adm_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!adm_!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 424w, https://substackcdn.com/image/fetch/$s_!adm_!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 848w, https://substackcdn.com/image/fetch/$s_!adm_!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 1272w, https://substackcdn.com/image/fetch/$s_!adm_!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!adm_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic" width="890" height="321" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:321,&quot;width&quot;:890,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:28331,&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/186573252?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.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_!adm_!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 424w, https://substackcdn.com/image/fetch/$s_!adm_!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 848w, https://substackcdn.com/image/fetch/$s_!adm_!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.heic 1272w, https://substackcdn.com/image/fetch/$s_!adm_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F63dc46be-c1d6-4ee4-8e7a-4e2cb5c7bbb3_890x321.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>What Makes a Topic a <em>Good</em> Topic?</h2><p>A <a href="https://docs.oasis-open.org/dita/v1.0/langspec/topic.html">DITA topic</a> is effective when it meets these criteria:</p><ul><li><p><strong>Single intent </strong>&#8212;<strong>&nbsp;</strong>It answers one question or supports one task</p></li><li><p><strong>Self-contained </strong>&#8212;<strong>&nbsp;</strong>It makes sense without relying on surrounding prose</p></li><li><p><strong>Context-aware</strong> &#8212;&nbsp;Metadata defines product, version, audience, and conditions of use</p></li><li><p><strong>Reusable by design </strong>&#8212;<strong>&nbsp;</strong>It can appear in multiple documents without rewriting</p></li></ul><p>If a piece of content reads awkward when reused, it probably wasn&#8217;t written as a true topic.</p><h2>Why DITA Topics Exist</h2><p>Before <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita">DITA</a>, most technical documentation followed a document (book) model:</p><ul><li><p>Long manuals</p></li><li><p>Linear chapters</p></li><li><p>Content written once, reused by copy-paste</p></li><li><p>Updates scattered across multiple files</p></li></ul><p>That model <em>breaks down</em> when you need to:</p><ul><li><p>Reuse content across products and versions</p></li><li><p>Publish to multiple outputs (PDF, web, help systems, chatbots)</p></li><li><p>Keep information accurate over time</p></li><li><p>Support automation, search, and AI</p></li></ul><p>DITA flips the model. Instead of starting with a document, you start with <strong>topics</strong>.</p><h2>The Three Core Types of DITA Topics</h2><p>Most DITA implementations rely on three foundational topic types. Each enforces intent.</p><h3>1. Concept Topics &#8212; &#8220;What is this?&#8221;</h3><p><a href="https://docs.oasis-open.org/dita/v1.0/langspec/concept.html">Concept</a> topics explain ideas, principles, or background information.</p><p><strong>Examples:</strong></p><ul><li><p>What a feature does</p></li><li><p>Why a setting exists</p></li><li><p>How a system behaves</p></li></ul><p>They help users understand before they act.</p><h3>2. Task Topics &#8212; &#8220;How do I do this?&#8221;</h3><p><a href="https://docs.oasis-open.org/dita/v1.0/langspec/task.html">Task</a> topics walk users through steps to complete a goal.</p><p><strong>Characteristics:</strong></p><ul><li><p>Clear goal</p></li><li><p>Prerequisites</p></li><li><p>Ordered steps</p></li><li><p>Expected results</p></li></ul><p>They answer action-oriented questions and work especially well for procedural content and automation.</p><h3>3. Reference Topics &#8212; &#8220;What are the details?&#8221;</h3><p><a href="https://docs.oasis-open.org/dita/v1.0/langspec/reference.html">Reference</a> topics provide structured facts.</p><p><strong>Examples:</strong></p><ul><li><p>Parameters</p></li><li><p>Commands</p></li><li><p>Error codes</p></li><li><p>Field definitions</p></li></ul><p>They prioritize accuracy, consistency, and scannability over narrative flow. &#129312;</p><p></p>]]></content:encoded></item><item><title><![CDATA[What is the Darwin Information Typing Architecture (DITA)?]]></title><description><![CDATA[DITA helps tech writers break docs into small, purposeful units &#8212; called topics &#8212; that can be reused, rearranged, and published consistently across many outputs]]></description><link>https://www.thecontentwrangler.com/p/what-is-the-darwin-information-typing</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-is-the-darwin-information-typing</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 14 Jan 2026 19:00:15 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!brRj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>The <strong><a href="https://help.heretto.com/en/heretto-ccms/get-started/introduction-to-dita/what-is-dita">Darwin Information Typing Architecture</a></strong> (DITA) is an XML-based standard for creating, managing, and publishing technical documentation as modular, reusable content. <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita">OASIS</a> maintains the DITA standard and provides access to information about its usage.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!brRj!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!brRj!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!brRj!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!brRj!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!brRj!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!brRj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/da8ac63c-a5d2-4ca3-a55a-26ee04d68133_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;:294769,&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/184361556?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_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_!brRj!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!brRj!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!brRj!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!brRj!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda8ac63c-a5d2-4ca3-a55a-26ee04d68133_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>DITA matters because it forces clarity and discipline at the point of creation. Each topic has a single intent &#8212; <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/concept.html">concept</a></strong>, <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/task.html">task</a></strong>, or <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/reference.html">reference</a></strong> &#8212; which makes content easier for people to scan and easier for machines to process. That structure enables reliable reuse, reduces duplication, and improves consistency across products, versions, and channels. Writers stop rewriting the same explanation five times and start managing one trusted source of truth.</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>DITA is also built for scale and change. Its specialization and inheritance model lets organizations extend the standard without breaking it, while maps assemble topics into many deliverables from the same content set. The result is faster updates, cleaner localization workflows, and publishing pipelines that can target PDFs, HTML, portals, and help systems from the same content base.</p><p>Finally, DITA future-proofs documentation for AI-driven delivery. Because topics are semantically typed and structurally consistent, search engines, chat systems, and retrieval-augmented generation pipelines can identify intent and return precise answers instead of dumping entire pages. In an era where documentation feeds intelligent systems, DITA gives technical writers a way to make content both human-readable and machine-ready.</p><p>DITA content is best managed in a <strong><a href="https://www.heretto.com/platform/ccms">component content management system</a></strong> designed specifically to help technical writers create, manage, and deliver documentation to the humans and machines that require it. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[What a DITA Topic Is (and Why It Matters)]]></title><description><![CDATA[Learn how "topics" power reuse, search, retrieval, and AI-ready documentation and discover why getting it right matters]]></description><link>https://www.thecontentwrangler.com/p/what-a-dita-topic-is-and-why-it-matters</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/what-a-dita-topic-is-and-why-it-matters</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 12 Jan 2026 23:20:59 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!W7J_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>If you work with the <a href="https://www.ditastrategies.com/media/introduction-to-dita">Darwin Information Typing Architecture</a> (DITA) &#8212; or plan to in the future &#8212; you likely to hear the word <em>topic</em> constantly. It sounds obvious; until you try to explain it to someone outside the DITA world, or worse, to someone who thinks a topic is just &#8220;a page&#8221; or &#8220;a section.&#8221; <em>It isn&#8217;t.</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_!W7J_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!W7J_!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!W7J_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ada83690-0ab3-4f9a-b4a4-4f56d43766b8_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;:488370,&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/184360237?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_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_!W7J_!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!W7J_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fada83690-0ab3-4f9a-b4a4-4f56d43766b8_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>A <strong>DITA topic</strong> is a small, self-contained unit of information designed to answer <em>one specific user need</em>. Not a chapter. Not a document. Not a dumping ground for everything related to a feature. One purpose. One job.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><h2>A DITA topic has three defining characteristics</h2><h3><strong>1. It has clear <a href="https://open.substack.com/pub/thecontentwrangler/p/what-is-intent-based-technical-documentation?utm_campaign=post-expanded-share&amp;utm_medium=web">intent</a></strong></h3><p>Every <a href="https://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/topicdefined.html">DITA topic</a> exists to do exactly one thing: explain a concept, describe a task, or provide reference information. This is not an accident. DITA enforces intent through information typing&#8212;most commonly <strong>concept</strong>, <strong>task</strong>, and <strong>reference</strong>.<br><br><strong>Related:</strong> <a href="https://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/topicstructure.html#topicstructurehttps://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/topicstructure.html#topicstructurehttps://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/topicstructure.html#topicstructure">Understanding DITA Topic Structure</a></p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wxv7!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wxv7!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!wxv7!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ead5f81e-f73e-44e9-a97b-a16520842329_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;:495603,&quot;alt&quot;:&quot;&quot;,&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/184360237?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_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_!wxv7!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!wxv7!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fead5f81e-f73e-44e9-a97b-a16520842329_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><p>That constraint forces writers to decide <em>why</em> the content exists before writing it. Is the user trying to understand something? Do something? Look something up? </p><blockquote><p>&#128204; <strong>If you cannot answer that question, you do not </strong><em><strong>yet</strong></em><strong> have a topic.</strong></p></blockquote><p>This is one of the reasons DITA content works so well with search, delivery platforms, and AI systems. Intent is explicit, not implied.</p><h3>2. It Stands on Its Own</h3><p>A DITA topic is designed to be meaningful outside the context of a book or manual. Someone might encounter it through search, a chatbot, an embedded help panel, or an AI answer engine. <strong>Regardless of how they encounter it the topic must still make sense.</strong></p><p>That means no &#8220;as described above,&#8221; no unexplained acronyms, and no reliance on surrounding pages or section headers to fill in critical gaps. <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">Context</a></strong> travels <em>with</em> the topic through <strong><a href="https://docs.oasis-open.org/dita/v1.0/archspec/metadataAttr.html">metadata</a></strong>, structure, and reuse &#8212; not through proximity.</p><p>This independence is what enables reuse at scale without copy-and-paste chaos.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!bUyg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!bUyg!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!bUyg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ba59e997-a9f1-4dbc-badc-08ba6d6116f6_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;:460548,&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/184360237?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_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_!bUyg!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!bUyg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fba59e997-a9f1-4dbc-badc-08ba6d6116f6_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>3. It&#8217;s Structurally Predictable</h3><p>A DITA topic follows a consistent structural pattern: a title, a body, and clearly defined elements inside. <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/task.html">Tasks</a></strong> have steps. <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/reference.html">References</a></strong> have tables and properties. <strong><a href="https://docs.oasis-open.org/dita/v1.0/langspec/concept.html">Concepts</a></strong> explain ideas, not procedures.</p><p>That predictability is not just for writers; it is for machines (computers, specifically). <strong><a href="https://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/topicstructure.html">Structured topics</a></strong> allow systems to classify, filter, assemble, personalize, and deliver content dynamically. This is why DITA topics are increasingly valuable in AI-driven environments.</p><p>Large language models do not &#8220;understand&#8221; documents. They perform far better with small, well-typed, semantically clear units of information.</p><h3>Why This Matters Now</h3><p>As search engines turn into <strong><a href="https://searchengineland.com/from-search-to-answer-engines-how-to-optimize-for-the-next-era-of-discovery-459964">answer engines</a></strong> and documentation gets consumed in fragments, the DITA topic becomes the atomic unit of knowledge delivery. Writers who understand how to design strong topics are not just explaining products; they are engineering intent-aware, machine-processable content that feeds knowledge systems.</p><p>If you want AI solutions to give users the <em>right</em> answer instead of a plausible one, start with better topics.</p><p><strong>If your content:</strong></p><ul><li><p>clearly states its purpose,</p></li><li><p>uses consistent information types,</p></li><li><p>exposes relationships through structure and metadata,</p></li></ul><p>AI can reason over it. If it doesn&#8217;t, AI guesses.</p><p><strong>Structured, semantically augmented DITA content allows AI systems to:</strong></p><ul><li><p>distinguish learning intent from execution intent,</p></li><li><p>select the right topic type for the moment,</p></li><li><p>avoid blending procedural steps into conceptual explanations,</p></li><li><p>reduce hallucination caused by context collapse.</p></li></ul><p>In short, it helps AI <strong>choose</strong> instead of <strong>invent</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_!tvWi!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!tvWi!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!tvWi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7419cd30-a197-4d63-8d34-b3acdf0b1a15_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;:446948,&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/184360237?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_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_!tvWi!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_1536x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!tvWi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7419cd30-a197-4d63-8d34-b3acdf0b1a15_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>What This Means For Tech Writing</h2><p>Technical writers are no longer just explaining products. They are designing intent-aware knowledge systems.</p><p><strong>Every time you:</strong></p><ul><li><p>choose a topic type,</p></li><li><p>enforce information typing discipline,</p></li><li><p>add meaningful metadata,</p></li><li><p>break monolithic docs into purpose-driven components,</p></li></ul><p>you make it easier for AI search engines to deliver the <em>right answer</em>, not just <em>an answer</em>.</p><p>In an AI search world, visibility depends less on keywords and more on whether machines can understand <strong>what your content is for</strong>.</p><p>DITA doesn&#8217;t just support that future. It anticipates it. &#129312;</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://www.thecontentwrangler.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">The Content Wrangler is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[The Organization of the Future Still Needs Tech Writers Who Can Roll Their Eyes]]></title><description><![CDATA[AI may generate, but people still drive (and tech writers still navigate)]]></description><link>https://www.thecontentwrangler.com/p/the-organization-of-the-future-still</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/the-organization-of-the-future-still</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Fri, 19 Sep 2025 14:10:21 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!A1Lk!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Every time I open LinkedIn these days, someone is announcing that AI has taken their job, or worse, that AI has taken their <em>soul</em>. They don&#8217;t say it quite like that, but the melodrama is there: &#8220;I used to write copy, but now ChatGPT does it in 30 seconds.&#8221; Cue ominous violin music.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!9CES!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!9CES!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 424w, https://substackcdn.com/image/fetch/$s_!9CES!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 848w, https://substackcdn.com/image/fetch/$s_!9CES!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 1272w, https://substackcdn.com/image/fetch/$s_!9CES!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!9CES!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic" width="1024" height="1536" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/131de637-304c-4bb4-9322-9d3e3a819604_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;:621878,&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/173883727?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_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_!9CES!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 424w, https://substackcdn.com/image/fetch/$s_!9CES!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 848w, https://substackcdn.com/image/fetch/$s_!9CES!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_1024x1536.heic 1272w, https://substackcdn.com/image/fetch/$s_!9CES!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F131de637-304c-4bb4-9322-9d3e3a819604_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>As a technical writer, I can&#8217;t help but laugh. Not because it isn&#8217;t serious&#8212;it is&#8212;but because most of us know the dirty little secret: the hardest part of this job has never been &#8220;writing words.&#8221; If it were, we&#8217;d have been replaced long ago by marketing interns with liberal arts degrees and a case of LaCroix. The real challenge is making sense of a world where nothing stays still long enough to document it.</p><p>Enter generative AI, the latest character in our tragicomic office play. </p><div class="paywall-jump" data-component-name="PaywallToDOM"></div><p>According to <a href="https://www.mckinsey.com/capabilities/people-and-organizational-performance/our-insights/the-organization-of-the-future-enabled-by-gen-ai-driven-by-people">McKinsey</a>, it&#8217;s going to &#8220;enable the organization of the future&#8221;. That&#8217;s consultant-speak for &#8220;brace yourselves, everything is changing again.&#8221; But if you read past the buzzwords, there&#8217;s an important caveat: organizations may be powered by gen AI, but they&#8217;ll still be driven by people. People like us &#8212; the ones who are supposed to explain this circus to everyone else without sounding like lunatics.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!A1Lk!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!A1Lk!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!A1Lk!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_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;:2440294,&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/173883727?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_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_!A1Lk!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!A1Lk!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F59b2fc4f-3201-43b9-abe9-72f5ce8a9ec4_1536x1024.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&#8217;ve already watched AI crank out draft documentation that looked eerily plausible. For about ten minutes, I felt my job security wobble. </p><p>Then I read it again. It was like watching a magician pull a rabbit out of a hat, only to realize the rabbit is taxidermied and missing an ear. Sure, it <em>looked</em> like documentation, but it was riddled with hallucinations, half-truths, and the kind of optimism usually reserved for timeshare salesmen. </p><p><a href="https://arxiv.org/abs/2305.11649">Researchers</a> have pointed out that &#8220;hallucinations&#8221; are one of gen AI&#8217;s most persistent flaws. That&#8217;s when it hit me: the AI can spin a story, but it can&#8217;t tell when the story is useful &#8212; or true. That part is still mine to do.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!4UHZ!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!4UHZ!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 424w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 848w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!4UHZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png" width="1024" height="1024" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1024,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:2060076,&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/173883727?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.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_!4UHZ!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 424w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 848w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!4UHZ!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f51b374-3f1f-4ebf-a228-85e59338954f_1024x1024.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>What does this all mean?</h3><p>What this means is that our work is changing shape. We&#8217;re no longer just scribes capturing the output of developers. We&#8217;re now interpreters of machine output, risk translators, and&#8212;if we&#8217;re honest&#8212;therapists for colleagues who are quietly terrified that a chatbot is going to replace them. </p><blockquote><p>AI may draft the words, but we&#8217;re the ones who make sure those words don&#8217;t cause a lawsuit, a meltdown, or a late-night call from a panicked customer who followed the wrong instructions.</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_!uDVL!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!uDVL!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!uDVL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic" width="1024" height="1024" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1024,&quot;width&quot;:1024,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:322012,&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/173883727?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.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_!uDVL!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 424w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 848w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.heic 1272w, https://substackcdn.com/image/fetch/$s_!uDVL!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F329b2693-355e-40c2-b53e-315dad4f9d4c_1024x1024.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><a href="https://www.mckinsey.com/capabilities/people-and-organizational-performance/our-insights/the-organization-of-the-future-enabled-by-gen-ai-driven-by-people">McKinsey says</a> the organizations that thrive will be the ones that embrace experimentation, trust, and adaptability. </p><p>That sounds lofty, but in practice it looks a lot like what tech writers already do: </p><ul><li><p>experiment with tools</p></li><li><p>figure out where they break</p></li><li><p>and then explain it to everyone else using metaphors that involve cooking or IKEA furniture</p></li></ul><p>We&#8217;re professional sense-makers in a world that makes less and less sense.</p><p>So, yes, gen AI is here to stay. It will keep generating, and people will keep being people &#8212; messy, skeptical, hopeful. And technical writers will be the ones stitching those two realities together, half comedian, half cartographer. In the &#8220;organization of the future,&#8221; that&#8217;s a job description AI can&#8217;t fake. &#129312;</p>]]></content:encoded></item><item><title><![CDATA[Are Technical Writers Next on the Automation Chopping Block?]]></title><description><![CDATA[A new SHRM report reveals which jobs are most at risk from automation&#8212;technical writers aren't on that list &#8212; yet]]></description><link>https://www.thecontentwrangler.com/p/are-technical-writers-next-on-the</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/are-technical-writers-next-on-the</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Wed, 14 May 2025 17:15:13 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!SWXP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Imagine you're deep in the trenches of a new product release, translating cryptic developer notes into something a human can read. You're not just writing&#8212;you're decoding, interpreting, and transforming a tangle of jargon into explicit, understandable content, as if rescuing it from a keyboard having a nervous breakdown.</p><p>And then, the existential question hits: <strong>Could a robot do this?</strong></p><p>According to the <strong><a href="https://www.shrm.org/content/dam/en/shrm/topics-tools/research/jobs-at-risk-brief.pdf?utm_source=www.theaivalley.com&amp;utm_medium=newsletter&amp;utm_campaign=apple-to-support-brain-implant-control-of-its-devices&amp;_bhlid=95bf4f75b85804afdd4f2d9d8608698a1716c6e3">latest report</a></strong> by the <strong><a href="https://www.shrm.org/home">Society for Human Resource Management</a></strong> (SHRM), business, finance, and HR jobs are the most likely to face the automation axe. But technical writers? We're not even on the list of highly at-risk jobs. (&#128558;&#8205;&#128168; Cue a cautious sigh of relief.)</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!SWXP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!SWXP!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!SWXP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/181e8f5d-40e0-4013-a9ba-8fc6f7299c00_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;:2234116,&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/163556233?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_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_!SWXP!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 424w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 848w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_1536x1024.png 1272w, https://substackcdn.com/image/fetch/$s_!SWXP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F181e8f5d-40e0-4013-a9ba-8fc6f7299c00_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><figcaption class="image-caption">Image: ChatGPT</figcaption></figure></div><p>Now, before you get too cozy, let's talk about why. AI tools can efficiently generate introductory text and automate formatting tasks, but they struggle to handle the nuance of technical writing. That's because technical writing involves more than slapping words on a page. </p><blockquote><p><strong>It requires its practitioners to wrangle complex concepts into something accurate and digestible, while anticipating the confusion of users who may not know an API from their elbow.</strong></p></blockquote><p>AI may help with routine tasks&#8212;generating tables, auto-summarizing, or suggesting simpler phrasing&#8212;but it just doesn't cut it when it comes to making sense of a feature held together by duct tape and hope or translating developer shorthand into something that won't make users cry.</p><p>So, while automation might take a bite out of some industries, technical writing&#8212;at least involving critical thinking, creativity, and plain old human intuition&#8212;still needs people. We're not just typists. We're sense-makers, storytellers, and those who can spot when a spec is about to send the entire project sideways.</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[Participate In The Women In Tech Comm Anthology Project]]></title><description><![CDATA[Women in Technical Communication is an anthology of the self-told stories of women working in tech comm from 1975 to today]]></description><link>https://www.thecontentwrangler.com/p/participate-in-the-women-in-tech</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/participate-in-the-women-in-tech</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Mon, 31 Mar 2025 13:30:59 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!Wzox!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Technical Communication as a field has changed over the last 50 years. <em><strong>Women in Technical Communication</strong></em> is an anthology of the self-told stories of women who did the technical communication work from 1975 to today. </p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Wzox!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Wzox!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 424w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 848w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Wzox!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.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;:4217462,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/jpeg&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/160073925?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.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_!Wzox!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 424w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 848w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!Wzox!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F200847ac-10cb-4d1e-88e4-fe773993e096_8256x5504.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><br>This period is especially interesting because it includes the PC revolution through the dot com boom through the birth of the internet as the everyday world, available on smartphones in nearly every corner of the world. Additionally, the field changed from predominately male to predominately female.<br><br>Technical communication industry veteran and university instructor, <a href="https://www.linkedin.com/in/sharonvburton/">Sharon Burton</a>, is looking to capture the stories of women working in the field. <br><br>Interested in participating? Respond to the <strong><a href="https://docs.google.com/forms/d/e/1FAIpQLSefkr4Aq0a0akmKxuwn4jpM6ZtDrGeZfj00jcmgVOhgW1MGiQ/viewform">Call for Writers</a></strong>.</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[Do You Have A Technical Documentation Story To Share?]]></title><description><![CDATA[The Content Wrangler is looking for tech docs pros willing to present case studies, best practices, and lessons learned with their peers]]></description><link>https://www.thecontentwrangler.com/p/do-you-have-a-technical-documentation</link><guid isPermaLink="false">https://www.thecontentwrangler.com/p/do-you-have-a-technical-documentation</guid><dc:creator><![CDATA[Scott Abel]]></dc:creator><pubDate>Tue, 25 Mar 2025 22:01:14 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!wID3!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg" length="0" type="image/jpeg"/><content:encoded><![CDATA[<h3><strong>Are you the leader of a tech docs team that&#8217;s been crushing it lately?</strong> </h3><ul><li><p>Maybe you ditched the endless chaos of sticky notes and random file names and finally figured out how to get your act together. </p></li><li><p>Perhaps you leveled up your info-management game to the point where your team runs like a German train schedule&#8212;efficient, precise, and oddly satisfying. </p></li><li><p>Or maybe &#8212; just maybe &#8212;&nbsp;you&#8217;ve cracked the elusive code on tracking metrics that mean something&#8212;no more pretending that page views alone are changing the world.</p></li></ul><p>Whatever your situation, you probably have a valuable story with lessons learned to share with others. If that&#8217;s the case, I&#8217;d like to hear from you. <br><br>I&#8217;m working to fill our webinar schedule with stories from practitioners working in the trenches. If you&#8217;d like to share your story, complete <a href="https://forms.gle/BnxamDbM98ZMCkD5A">this short form</a>. I&#8217;ll get back to you shortly to schedule a call to discuss the opportunity.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wID3!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wID3!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 424w, https://substackcdn.com/image/fetch/$s_!wID3!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 848w, https://substackcdn.com/image/fetch/$s_!wID3!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!wID3!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!wID3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg" width="1456" height="1092" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1092,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:1730400,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/jpeg&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://www.thecontentwrangler.com/i/158793640?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.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_!wID3!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 424w, https://substackcdn.com/image/fetch/$s_!wID3!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 848w, https://substackcdn.com/image/fetch/$s_!wID3!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!wID3!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93596216-c68a-4248-a247-b89905309ed6_3671x2753.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><figcaption class="image-caption">Photo by <a href="https://unsplash.com/@etiennegirardet?utm_content=creditCopyText&amp;utm_medium=referral&amp;utm_source=unsplash">Etienne Girardet</a> on <a href="https://unsplash.com/photos/black-flat-screen-tv-turned-on-at-the-living-room-EP6_VZhzXM8?utm_content=creditCopyText&amp;utm_medium=referral&amp;utm_source=unsplash">Unsplash</a></figcaption></figure></div><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><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>]]></content:encoded></item></channel></rss>