<?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:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jameson Buckley on Medium]]></title>
        <description><![CDATA[Stories by Jameson Buckley on Medium]]></description>
        <link>https://medium.com/@jameson_64305?source=rss-874e5799b53d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*29pkhZsncXZWbDx3</url>
            <title>Stories by Jameson Buckley on Medium</title>
            <link>https://medium.com/@jameson_64305?source=rss-874e5799b53d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 15 Nov 2026 09:38:29 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jameson_64305/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Only 12% of Finance Leaders Say Marketing’s Numbers Survive a Challenge.]]></title>
            <link>https://medium.com/@jameson_64305/only-12-of-finance-leaders-say-marketings-numbers-survive-a-challenge-6a4a43339900?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/6a4a43339900</guid>
            <category><![CDATA[marketing-analytics]]></category>
            <category><![CDATA[roi]]></category>
            <category><![CDATA[b2b-marketing]]></category>
            <category><![CDATA[finance]]></category>
            <category><![CDATA[demand-generation]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Fri, 13 Nov 2026 17:58:49 GMT</pubDate>
            <atom:updated>2026-11-13T17:58:49.628Z</atom:updated>
            <content:encoded><![CDATA[<h3>Only 12% of Finance Leaders Say Marketing’s Numbers Survive a Challenge. Two 2026 Studies Explain Why.</h3><h4>What the ANA and NewtonX finance survey and Bain and Google’s study of 1,397 executives say about the vocabulary problem between marketing and finance</h4><p>Marketing teams went into 2026 planning season with more dashboards than ever.</p><p>Finance teams went in with a different question: which of these numbers can we actually plan around?</p><p>Two studies published this year put figures on that gap. One asked finance leaders directly how much they trust marketing’s measurement. The other asked both sides what they want from each other. Read together, they point to a problem that has less to do with budgets or priorities and more to do with words.</p><p>We pulled the findings together because they shape how every B2B marketing channel gets judged in 2027, including content syndication, which is the channel we work in.</p><h3>Study one: the ANA and NewtonX finance survey</h3><p>The ANA’s Confident B2B Marketer report has surveyed marketing leaders before. The 2026 edition added something new.</p><p>NewtonX fielded the survey in April 2026 to 202 senior B2B marketing leaders at director level and above. It also surveyed 150 CFOs, VPs of finance and heads of revenue. On top of that, the team ran 23 AI-moderated interviews with high-confidence marketers and 8 longer interviews with senior finance executives.</p><p>The headline numbers form a staircase.</p><p>59% of marketers said they can measure marketing’s financial impact.</p><p>45% of finance leaders agreed that marketing can do that.</p><p>37% of finance leaders said marketing’s impact had been reliable enough to use for planning and forecasting.</p><p>12% said that measurement holds up under pressure.</p><p>Each step down is a harder test. Measuring something is one bar. Forecasting with it is a higher one. Defending it when a CEO or board member pushes back is the highest, and very few marketing numbers clear it in finance’s eyes.</p><p>The interviews with finance executives added a useful detail. Trust erodes in specific moments: during planning cycles, under scrutiny, and when budgets get tight. It rarely disappears all at once.</p><h3>The Vocabulary Gap</h3><p>The report gives the main cause a name. It calls it the Vocabulary Gap, meaning the absence of shared definitions for pipeline, attribution and impact.</p><p>When marketing, sales and finance each define pipeline differently, the same quarter can get three different verdicts. The report lists what follows from that: AI outputs get questioned, data integrations fragment, brand investment gets cut, internal champions lose debates and forecasts miss.</p><p>The authors call closing this gap the most immediate and highest-leverage move most B2B marketing leaders can make.</p><p>That is a useful framing because it is fixable without new software. It takes a meeting and a written agreement.</p><h3>Study two: Bain and Google on proof of performance</h3><p>Bain and Google’s Leaders and Laggards Survey 2026 covered 1,397 senior marketing and finance executives around the world. Bain published the findings on July 2, 2026.</p><p>Its main finding is that marketing and finance largely agree on what matters.</p><p>Both groups named return on marketing investment and revenue impact as their top success measures.</p><p>More than half of each group said that showing direct revenue impact is the single most important thing marketing can do to strengthen its standing with finance.</p><p>About 70% of each group expect performance investments to pay back within months or quarters. About 40% expect brand investments to take a year or more.</p><p>So the two functions share goals and even share timelines. Where they split is on proof.</p><p>Only 41% of marketers said they feel properly equipped with the data, tools and measurement capabilities to tie performance to business outcomes. Only 19% described their AI capabilities for analytics and insights as mature.</p><h3>What the strong relationships look like</h3><p>Bain split companies by how well their marketing and finance teams work together. 501 respondents described a strong relationship and 138 described a weak one.</p><p>Companies with strong relationships were 2.5 times more likely to have credible data.</p><p>They were also about 1.5 times more likely to be market share and revenue growth leaders in their sectors. Bain’s text describes the revenue link as almost two times higher growth.</p><p>The habits Bain describes in those companies are concrete:</p><ul><li>They lock metrics before campaigns launch, so nobody redefines success after the results come in.</li><li>They share failures alongside successes, which Bain calls radical transparency in data.</li><li>They set shared, realistic payback expectations, especially for brand campaigns that take longer to show up in revenue.</li></ul><p>None of these habits depends on a particular tool. They depend on agreeing on terms early and reporting honestly afterward.</p><h3>Putting the two studies side by side</h3><p>The ANA and NewtonX data shows the symptom: finance trust drops sharply as the stakes rise.</p><p>The Bain data shows that the goals are shared, so the trust gap is about evidence and definitions.</p><p>Both reports land on the same first fix. Write down what pipeline, an opportunity and attribution mean before the money is spent, and get finance to sign off on those definitions.</p><h3>A cohort approach that holds up</h3><p>Our research on proving syndication ROI to a CFO builds on these findings. The core idea is to stop reporting a running total and start reporting cohorts.</p><p>A cohort is every lead delivered in one month, followed as a group from delivery to closed-won revenue.</p><p>The ROI formula for each cohort is simple. Take closed-won revenue, subtract program spend, then divide by spend. You run it for each delivery month separately, and you keep the cohort open until the payback window you agreed on with finance has ended.</p><p>Timing matters here. SQLs from a syndication cohort usually appear within weeks of delivery. Opportunities and revenue arrive over the following months, at a pace set by your sales cycle. Setting the payback window to match that cycle is what keeps a CFO from judging a cohort before it has had time to convert.</p><p>This also lines up with the Bain payback finding. If 70% of finance leaders expect performance spend to pay back within months or quarters, a cohort report with an agreed window speaks their language.</p><h3>Why lead-level records help with the Vocabulary Gap</h3><p>One reason we think syndication is a good test case is the record each lead carries.</p><p>A syndicated lead arrives with contact details, the specific asset the person downloaded, a timestamp and the answers to qualifying questions. Those fields can be matched against CRM records.</p><p>That gives marketing and finance something concrete to define terms around. An accepted lead, an SQL and an opportunity can each be tied to a named record with a date, which is much easier to audit than a modeled share of a multi-touch path.</p><h3>Questions to settle with finance before your next program</h3><p>Based on both studies, these are the questions we would bring to a planning meeting with finance:</p><ol><li>What counts as pipeline, and at which stage does marketing stop getting credit?</li><li>What payback window fits our actual sales cycle?</li><li>Which cost do we report: total spend, or spend on accepted leads only?</li><li>How will we report a cohort that misses?</li><li>When results come in, whose conversion rates do we re-forecast with: vendor benchmarks or our own?</li></ol><p>The last two questions get skipped most often. Bain’s leaders answer them in advance, before any results exist to argue over.</p><p>The full research on proving content syndication ROI, including a scorecard and a worked pilot example, is here: <a href="https://lead-spot.net/research/how-to-prove-content-syndication-roi-to-your-cfo/">https://lead-spot.net/research/how-to-prove-content-syndication-roi-to-your-cfo/</a></p><p><strong>Sources</strong></p><ul><li><a href="https://www.newtonx.com/article/confident-b2b-marketer-2026/">ANA and NewtonX, Confident B2B Marketer 2026</a></li><li><a href="https://www.bain.com/insights/the-marketing-finance-divide-is-about-proof-of-performance-not-priorities/">Bain and Company, The Marketing-Finance Divide Is About Proof of Performance, Not Priorities (July 2, 2026)</a></li><li><a href="https://lead-spot.net/research/how-to-prove-content-syndication-roi-to-your-cfo/">LeadSpot, How to Prove Content Syndication ROI to Your CFO</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6a4a43339900" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Run a review drill on your docs repo in one afternoon]]></title>
            <link>https://medium.com/@jameson_64305/run-a-review-drill-on-your-docs-repo-in-one-afternoon-7b7a2c4e3a1e?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/7b7a2c4e3a1e</guid>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[github]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[documentation]]></category>
            <category><![CDATA[technical-writing]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Fri, 13 Nov 2026 16:17:54 GMT</pubDate>
            <atom:updated>2026-11-13T16:17:54.359Z</atom:updated>
            <content:encoded><![CDATA[<h4>Eight small tests, one fake team, and a record you can keep next to every release</h4><p>Most teams find out how their docs review works on a bad day.</p><p>A customer follows a guide and something breaks. Someone asks who approved that page. The answer takes an hour of scrolling through pull requests, and it ends with “I think it was reviewed.”</p><p>We would rather find that out on a quiet afternoon, with fake content, in a repository nobody depends on.</p><p>This piece is a practical drill for doing that. It is based on a research report we published at Docsio on review controls in GitHub and GitLab. The report proposes the scenarios below. It does not claim anyone has run them, and neither do we. Think of this as a plan you can try.</p><h3>Before you start: write the policy in one paragraph</h3><p>The drill only works if you know what you are testing against.</p><p>Write down, in plain words, what review a docs change needs before it reaches readers. Who has to approve which kinds of pages. What happens if the page changes after approval. Which routes are allowed to publish.</p><p>Keep it short. One paragraph is plenty for a small team.</p><p>If you cannot write that paragraph, that is your first finding. The tools can only enforce a policy someone decided on.</p><h3>Set up a disposable repository</h3><p>Create a throwaway repo that mirrors how your real docs repo is configured. Same plan, same visibility, same branch rules, same owner file, same deploy workflow pointed at a test destination.</p><p>Use fictional content. A made-up setup guide and a made-up troubleshooting page are enough.</p><p>Then write down four facts before you begin: your plan or tier, whether the repo is public or private, which rule type you are using, and today’s date. Platform behavior differs across tiers and between hosted and self-managed versions, so a result without those details is hard to trust later.</p><h3>Meet Northstar Guides</h3><p>The report uses a fictional team to make the drill concrete. We will borrow it.</p><p>At Northstar Guides, support owns troubleshooting prose. Engineering owns commands and code samples.</p><p>That split creates a real question. When a troubleshooting page includes a command, does one approval cover both? Or does the page need a yes from support for the words and a yes from engineering for the command?</p><p>There is no universal answer. The point is that Northstar has to decide, and then check that its configuration does what it decided.</p><p>Your team probably has a version of this split. Marketing owns the pricing FAQ and finance owns the numbers. Product owns the onboarding guide and security owns the SSO steps. Name yours before you run the drill.</p><h3>The eight scenarios</h3><p>Run each one with a fictional change. For each, write down what you expected, what happened, and which account you used.</p><ol><li>Edit a guide nested a few folders deep. Does the right owner get requested, and is their approval required to merge?</li><li>Add a brand new section that no existing owner rule covers. Who gets asked? Can it merge with no owner approval at all?</li><li>Get a change approved, then edit an instruction in it. Does the approval stay, go away, or partly go away?</li><li>Repeat a change using an ordinary contributor account instead of an admin. Admin accounts often bypass rules by default, so they make results look stricter than they are.</li><li>Make a change using the identity your release process runs as. What can that identity do without a person approving it?</li><li>Try to run a test release before the change is approved. Does anything stop it?</li><li>Compare the record from a preview build with the record from the real release. Do they point at the same revision?</li><li>Change the ownership configuration itself. Who can do that, and does anyone have to approve it?</li></ol><p>Scenario 8 is the one teams skip most often. If the person who approves content can also quietly edit who approves content, the rest of the drill matters less.</p><h3>How to record what you find</h3><p>Some results will surprise you. The report gives a useful way to describe them.</p><p>If something publishes without the review your policy expected, and it happened through a route your team allows, call it an exception to review enforcement. A documented hotfix path is a good example. It is a gap in your policy coverage, and it may be a perfectly reasonable one.</p><p>Avoid calling it a platform failure unless the platform did something different from its own documentation.</p><p>And for any route you did not test, write “unknown.” A hosting dashboard you forgot about, a manual upload, a script from launch week. An honest list of unknowns is more useful than a clean report that skips them.</p><h3>Keep a six-line release record</h3><p>After the drill, most teams want something ongoing. The report proposes a short record that links reviewed content to the published result. It has six entries.</p><ul><li><strong>Content candidate:</strong> the revision or a draft identifier that will not change.</li><li><strong>Review decision:</strong> who reviewed it, what scope they covered, when, and which candidate they saw.</li><li><strong>Effective policy:</strong> the rules that applied, plus any exception someone made on purpose.</li><li><strong>Validation:</strong> check results, the revision they ran on, and the preview if one matters.</li><li><strong>Release:</strong> the deployed revision or artifact, and where it went.</li><li><strong>Follow-up:</strong> any correction, withdrawal or replacement afterwards.</li></ul><p>You do not need a new tool for this. Each entry can link to a system you already have, like a pull request, a CI run or a deploy log.</p><p>One detail matters a lot. Use stable references, like a commit or artifact identifier. Branch names move. “Main” on Tuesday is a different thing from “main” on Friday.</p><p>The record has limits worth stating. It shows who approved which revision. It cannot show that the content is accurate, and it cannot show that nothing unauthorized happened outside the routes it tracks.</p><h3>Scale review to what the change can break</h3><p>A drill like this can push teams toward reviewing everything heavily. The report pushes back on that, and we agree.</p><p>A factual change to an authentication guide deserves more care than fixing a typo in a footer. Your policy can say so.</p><p>The report also suggests defining the smallest useful review package. That means the changed material, the source that supports it, who the page is for, and a preview when layout changes the meaning. A table that collapses on mobile, for example, or a code block that wraps badly.</p><p>If reviewers get that package every time, reviews get faster without getting weaker.</p><h3>AI-drafted pages follow the same rules</h3><p>More docs teams now start pages with an AI draft. The report’s position is simple. AI-drafted text should meet the same evidence expectations as anything a person wrote.</p><p>Fluent writing can make a page feel already reviewed. It still needs the same approval on the same revision that ships.</p><h3>Leave room for emergencies</h3><p>The last piece of the drill is deciding how urgent fixes work.</p><p>If a page tells customers to run the wrong command, you want it fixed in minutes. So keep an emergency route. Just record three things each time it is used: who authorized it, what was published, and what follow-up is still open.</p><p>That turns the side door into a known door.</p><h3>What you will have at the end</h3><p>After one afternoon, you should have a one-paragraph policy, eight results with the accounts you used, a list of exceptions, a list of unknowns, and a release record format your team can start using on the next change.</p><p>That is a lot more than “I think it was reviewed.”</p><p>The full research behind this drill, including the GitHub and GitLab details for each control, is on the Docsio research page: <a href="https://docsio.co/research/docs-as-code-review-enforcement">https://docsio.co/research/docs-as-code-review-enforcement</a></p><p>Docsio builds branded docs sites from a website URL in about 30 seconds. You can try it at Docsio.co.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7b7a2c4e3a1e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[You changed your docs indexing policy. How do you know it worked?]]></title>
            <link>https://medium.com/@jameson_64305/you-changed-your-docs-indexing-policy-how-do-you-know-it-worked-4a5aff9ccfb5?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/4a5aff9ccfb5</guid>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[documentation]]></category>
            <category><![CDATA[seo]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[google-search-console]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Tue, 10 Nov 2026 15:51:35 GMT</pubDate>
            <atom:updated>2026-11-10T15:51:35.417Z</atom:updated>
            <content:encoded><![CDATA[<h4>A six-step audit and three kinds of measurement for versioned documentation, walked through with a fictional product</h4><p>Someone on your team spends a week sorting out how your versioned docs show up in Google.</p><p>They decide which releases stay searchable, which duplicate addresses get consolidated, and what happens to the retired release. They ship the settings. Everyone moves on.</p><p>Three months later, a support ticket arrives from a customer on an older release. They followed the setup guide from Google and it described a screen they don’t have.</p><p>Was the policy wrong? Did the site ignore it? Did Google pick something else? Without a record, nobody can say.</p><p>Our team at Docsio published a research report on versioned documentation and search indexing. Most of it covers how to make the decisions. This piece covers the part after: checking what actually happened. The report proposes the method. It wasn’t run as an experiment, and no traffic was measured. I’ll walk through it with the report’s made-up product, Atlas.</p><h3>Meet Atlas</h3><p>Atlas has four kinds of documentation:</p><ul><li><strong>Release 4:</strong> current</li><li><strong>Release 3:</strong> older, still supported</li><li><strong>Release 2:</strong> retired, kept as a reference</li><li><strong>Release 5:</strong> a private preview</li></ul><p>There’s also a duplicate domain alias that serves the same pages at a second address.</p><p>The report gives Atlas a starting set of decisions. Each one begins with what a reader needs and ends with a question you can check.</p><ol><li><strong>Release 4 current guides.</strong> Readers want to learn the current product. Keep them eligible for indexing. Check: do pages identify release 4 and serve release 4 instructions?</li><li><strong>Release 3 guides that changed.</strong> Readers run a supported older installation. Keep the distinct guides eligible. Check: can a release 3 reader stay in release 3?</li><li><strong>The duplicate domain alias.</strong> Readers get the same page at another address. Prefer the primary address. Check: do both addresses really carry the same content?</li><li><strong>The release 2 archive.</strong> Readers follow a retained historical reference. Keep it public, and exclude it from Google if your support policy calls for it. Check: does the archive open without implying it’s current?</li><li><strong>The release 5 preview.</strong> Reviewers read unpublished instructions. Use access control. Check: is access denied without permission?</li></ol><p>Those checks are what the audit tests. Before anything ships, the report suggests three sign-offs: the product owner confirms which releases are supported, the docs owner confirms which pages are true duplicates, and whoever owns search maps each decision to a control.</p><h3>The six-step audit</h3><h4>Step 1: Freeze the policy record</h4><p>Write down the decisions for the release under review, and keep that record separate from anything you observe later.</p><p>This sounds like paperwork. It’s the step that stops a team from quietly rewriting the policy to match whatever Google did. The report also warns against changing the policy while you’re still waiting for results.</p><h4>Step 2: Pick representative pages</h4><p>Choose pages for each policy case. For Atlas, that means at least a current release 4 guide, a changed release 3 guide, an unchanged page that exists in both releases, and an archive page from release 2.</p><p>Include a deep page, several clicks from the homepage, and the same page on the alias domain. Write down why you chose each one.</p><h4>Step 3: Inspect the live output</h4><p>Open each page as it’s actually served. Record the status code, where any redirect lands, which release’s content appears, the indexing rule, the canonical tag, the crawler rule that applies to the path, and whether the page is in the sitemap.</p><p>The point is to look at the delivered page instead of the settings screen. Hosts generate a lot of this automatically, and a theme or custom build can change the result.</p><h4>Step 4: Save the time and the deployed revision</h4><p>Note when you looked and which build was live.</p><p>Without this, you’ll eventually compare a Search Console report against a build nobody can identify. The report calls this comparing results against an unknown build.</p><h4>Step 5: Read what Google indexed</h4><p>In Search Console, look up each page’s last crawl date and the canonical Google selected.</p><p>Keep the live URL Inspection test separate. The live test tells you whether Google can fetch the page right now. It can’t predict which canonical Google will choose. The indexed data is where that choice shows up.</p><p>Also remember that being in a sitemap doesn’t mean a page was indexed.</p><h4>Step 6: Classify every mismatch</h4><p>When the indexed result differs from the policy, sort it into one of four buckets:</p><ol><li><strong>Site output problem:</strong> the page is serving the wrong tag, rule or content.</li><li><strong>Policy disagreement:</strong> the page is doing what you asked, and Google chose differently.</li><li><strong>Outdated observation:</strong> Google hasn’t recrawled since the change.</li><li><strong>Unresolved indexing outcome:</strong> you can’t tell yet.</li></ol><p>Each bucket points to a different next step. A site output problem goes to whoever owns the build. An outdated observation mostly needs patience. Lumping them together is how teams end up fixing the wrong thing.</p><h3>What to measure afterward</h3><p>The report separates three kinds of observation. They’re easy to blur, and each answers a different question.</p><h4>Technical observations</h4><p>These cover what the site delivered and what Google reported. For Atlas, a good one is whether the changed release 3 setup guide’s Google-selected canonical is itself. If Google folded it into release 4, release 3 readers will have a hard time finding it.</p><h4>Discovery observations</h4><p>Impressions, clicks and version-specific queries, over a stated period.</p><p>Context matters here. If the release 2 archive loses impressions after you deliberately excluded it, that’s the expected result. If a supported release 3 guide loses the same impressions, something needs investigating.</p><p>The report flags two quirks. Search Console credits most performance data to the canonical URL, so traffic for a duplicate may show up under a different page. It also leaves out some queries. Read the numbers with both in mind.</p><h4>Reader observations</h4><p>This is the one teams tend to skip.</p><p>Give a reviewer a release and a task, and see where they end up. For Atlas, the report suggests three tasks: configure release 3, install release 4, and find the retained release 2 reference. The reviewer records which version they reached and why.</p><p>It’s a task check with a few people, and it won’t estimate anything about your whole audience. It does answer the question the policy was written for. Total clicks can’t stand in for it.</p><h3>What this method won’t tell you</h3><p>The report is careful about scope, and so should you be.</p><p>It covers Google and Read the Docs only. Other search engines may treat these rules differently. No source it reviewed sets a universal number of versions to index, a guaranteed recrawl timeline, or an expected traffic gain.</p><p>A handful of representative pages shows you whether each policy case works. It doesn’t estimate how many pages across the site are wrong.</p><p>What you get is a record. When that support ticket arrives three months later, you can look up what you decided, what the page served, and what Google chose, and work out which part went wrong.</p><p>We build docs sites at Docsio, and versioned docs come up constantly. If you’re about to change how yours are indexed, start the record before you change the settings.</p><p>The full report, with sources from Google Search Central, Search Console Help and Read the Docs, is at docsio.co/research.</p><p><strong>Source:</strong> <a href="https://docsio.co/research/versioned-documentation-search-indexing">Which versions of your documentation should Google index?</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4a5aff9ccfb5" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[322,292 Californians Asked to Be Deleted. Marketers Should Read That as Feedback.]]></title>
            <link>https://medium.com/@jameson_64305/322-292-californians-asked-to-be-deleted-marketers-should-read-that-as-feedback-24085415fff0?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/24085415fff0</guid>
            <category><![CDATA[privacy]]></category>
            <category><![CDATA[marketing]]></category>
            <category><![CDATA[data-privacy]]></category>
            <category><![CDATA[california]]></category>
            <category><![CDATA[b2b-marketing]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Mon, 09 Nov 2026 17:27:18 GMT</pubDate>
            <atom:updated>2026-11-09T17:27:18.593Z</atom:updated>
            <content:encoded><![CDATA[<h4>What the first months of California’s DROP sign-ups say about how buyers feel about being found, and what it asks of the teams who want to reach them.</h4><p>By July 1, 2026, 322,292 Californians had filled out a form asking to be erased.</p><p>Each request went to every registered data broker in the state, nearly 600 of them by the count GovTech reported, asking each one to delete what it held on them and to stop collecting more.</p><p>The platform they used is DROP, the Delete Request and Opt-out Platform run by CalPrivacy. Most of the coverage so far has been about compliance: deadlines, penalties, registration. We wrote about that side in our own research.</p><p>This piece is about the people. When a few hundred thousand people take time out of their day to ask for less contact, we think marketers should treat it as a signal about their audience.</p><h3>What signing up takes</h3><p>According to CalPrivacy’s executive director, Tom Kemp, signing up takes about six to seven minutes.</p><p>A resident verifies that they live in California, either by entering basic personal details or by signing in through Login.gov. Then they build a profile and choose what to include: names, birth dates, ZIP codes, email addresses, phone numbers, even vehicle identification numbers.</p><p>The more they add, the more brokers can match. Kemp described the required information as the “bare minimum” needed to find people in broker records. The agency doesn’t ask for Social Security numbers, driver’s license numbers or credit card numbers.</p><p>So every one of those 322,292 people decided that six or seven minutes, plus handing over their own email and phone number, was worth it to be found less often.</p><h3>What they said they wanted</h3><p>GovTech’s reporting didn’t include a survey of individual motives. What it did include was how the agency describes the benefits, and those line up closely with complaints any B2B buyer would recognize.</p><p>Kemp said people who sign up should see fewer ads based on their demographics. He said they should see fewer text scams, less email spam and less junk mail. He called the whole thing “an investment” in making yourself more secure.</p><p>He also put the problem simply: “Our data is their product, and they don’t sell it back to us.”</p><p>That sentence is worth sitting with if your pipeline depends on someone else’s contact database. The person on the other end of a cold email is usually a person who never chose to be on the list.</p><h3>Who sells what</h3><p>The registry gives a rough picture of what brokers trade in. GovTech’s breakdown of the nearly 600 registered brokers included these figures:</p><ul><li>110 sell precise location data</li><li>More than 40 sell identity data that can include Social Security numbers</li><li>18 sell data about minors</li><li>About 30 sell to developers of generative AI</li><li>More than 20 sell to foreign entities</li></ul><p>Kemp also said there are “clearly more than 600” brokers operating once you count the ones that haven’t registered, and the agency’s enforcement team is investigating reports of those.</p><p>Most B2B marketers will never touch a location feed. But the same registry includes the companies that sell names, work emails and direct dials, and DROP doesn’t sort brokers by how harmless their product feels.</p><h3>Why the number keeps climbing</h3><p>There are two reasons we expect the 322,292 figure to grow.</p><p>The first is that sign-ups are permanent. Once someone registers, brokers have to keep honoring the request and screen new records against it before selling them. Nobody ages out of the list.</p><p>The second is visibility. Brokers began processing deletions on August 1, 2026. Per the agency, people in the first round should have started seeing results in late October. Kemp said he expects sign-ups to grow as purges happen and word spreads.</p><p>There is plenty of room. More than 30 million Californians haven’t signed up yet, and Kemp believes many of them simply don’t know the program exists.</p><p>Enforcement adds pressure on the broker side. GovTech reported that brokers who failed to register have settled for $35,000 to $55,000, and that DataMasters of Texas agreed to a $45,000 fine and was ordered to stop selling Californians’ data. Kemp said the fines appear to be pushing more brokers to register, and that the agency is prepared to pursue fines in the “tens of millions of dollars.”</p><h3>What we take from it as marketers</h3><p>Under 1% of the state has signed up. On its own, that won’t empty anyone’s CRM this quarter.</p><p>What stands out to us is the direction. Every month the list gets a little longer, nobody leaves it, and the people on it are the ones most annoyed by contact they didn’t ask for. Those are often the same senior, busy, frequently contacted buyers B2B teams want most.</p><p>A few things follow from that.</p><p><strong>Ask before you reach out.</strong> A buyer who gives you an email address in exchange for something they wanted is in a different position from a buyer whose email you rented. California’s own guidance treats information a person knowingly shares with a business differently from information a broker collects and sells. Opt-in channels, from your own forms to content syndication, line up with how people are telling regulators they want to be treated.</p><p><strong>Give them a reason that is about them.</strong> The motives Kemp described were about spam, scams and irrelevant ads. A research report, a benchmark or a useful tool gives a buyer a reason to raise their hand. That trade is easy to understand and easy to honor.</p><p><strong>Make leaving easy too.</strong> If people will spend seven minutes on a government form to stop being contacted, a one-click unsubscribe that works within days costs you very little and earns some trust.</p><p><strong>Expect quieter regions.</strong> As DROP grows, purchased California coverage will thin out in ways that won’t show up as bounces. The contact still has the job. They just stop showing up in the data you can buy.</p><h3>The part nobody can buy</h3><p>We sell lead generation, so we have an obvious interest here. Our programs are built on buyers who fill out a form to get a specific piece of content, and we think that model fits where privacy rules are heading.</p><p>But the bigger point stands without us. Hundreds of thousands of people have now told the state, in writing, that they want fewer strangers holding their contact details. The companies that keep reaching those people will be the ones the buyers chose to hear from.</p><p>That permission is the one data asset DROP can’t delete.</p><p><em>Sources: GovTech, “Why 300K Californians Signed Up to Have Personal Info Removed” (July 2026); CalPrivacy DROP overview. This article isn’t legal advice.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=24085415fff0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Your SEO Tool Says Your Page Covers 60% of AI Fan-Out Queries. Here’s How to Read That Number.]]></title>
            <link>https://medium.com/@jameson_64305/your-seo-tool-says-your-page-covers-60-of-ai-fan-out-queries-heres-how-to-read-that-number-842d489d62b0?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/842d489d62b0</guid>
            <category><![CDATA[content-marketing]]></category>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[small-business]]></category>
            <category><![CDATA[seo]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Mon, 09 Nov 2026 17:01:29 GMT</pubDate>
            <atom:updated>2026-11-09T17:01:29.607Z</atom:updated>
            <content:encoded><![CDATA[<p>A plain-English walkthrough for small business owners, using one fictional bakery and three questions you can ask about any coverage score.</p><p>A new number has started showing up in SEO tools and agency reports.</p><p>It usually looks something like this: “Your page covers 6 of 10 fan-out queries.” Or “Fan-out coverage: 60%.”</p><p>If you run a small business, that number can feel like a grade. Sixty percent sounds like a D. You start wondering what you missed and how fast you can fix it.</p><p>Before you rewrite anything, it helps to know where that number comes from and what it can and cannot tell you.</p><p>We spent time with the public documentation from Google, OpenAI and Perplexity, plus the largest public study on the topic from Ahrefs. This piece takes what we learned and applies it to one practical question: what should a small business owner do when a tool hands them a coverage score?</p><h3>First, what fan-out means</h3><p>When someone asks an AI search tool a question, the tool may split it into several smaller searches before it answers.</p><p>Google’s documentation says AI Overviews and AI Mode may run “multiple related searches across subtopics and data sources” to build a response. That is query fan-out.</p><p>The word “may” matters. Google describes something its systems can do. It does not publish a list of the searches it ran for any particular question.</p><p>OpenAI’s developer docs say its web search tool usually returns the queries it searched, but not always. Perplexity’s developer docs show example records of queries and results.</p><p>So some fan-out searches can be seen, some of the time, through developer tools. Most everyday users never see them at all.</p><p>Keep that in mind, because it shapes everything about a coverage score.</p><h3>Meet Two Rivers Bread Co.</h3><p>To make this concrete, we will use a fictional business.</p><p>Two Rivers Bread Co. is a small bakery in Lancaster, Pennsylvania. The owner, Dana, sells sourdough loaves at the counter and runs a weekend sourdough starter class for about a dozen people at a time.</p><p>Dana wrote a page called “How to keep a sourdough starter alive.” It gets steady Google traffic. She wants it to show up when someone asks ChatGPT or Google AI Mode for help with a sluggish starter.</p><p>She runs the page through a tool. The tool reports:</p><p>“Fan-out coverage: 6 of 10 queries (60%).”</p><p>It lists the four “missing” queries:</p><ol><li>Can I use tap water for sourdough starter?</li><li>Why does my starter smell like nail polish remover?</li><li>Best flour for sourdough starter</li><li>Sourdough starter vs commercial yeast</li></ol><p>Dana’s first instinct is to add four new sections to the page. Here is what we would ask first.</p><h3>Question 1: Where did these ten queries come from?</h3><p>This is the most important question, and many reports do not answer it on the screen.</p><p>There are a few ways a tool can produce a list like this:</p><ul><li><strong>Returned by an interface.</strong> The tool sent a question to an AI system through a developer API, and the API returned the searches it ran.</li><li><strong>Observed in sessions.</strong> The tool collected real responses and pulled out the searches recorded in them.</li><li><strong>Generated by a model.</strong> The tool asked an AI model to guess what related questions someone might search.</li></ul><p>These are very different things.</p><p>A query returned by an interface tells you that one system ran that search for one request, at one point in time.</p><p>A model-generated list is a set of reasonable guesses. It can be useful for brainstorming. It tells you nothing about what Google, ChatGPT or Perplexity actually searched.</p><p>If Dana’s tool generated its ten queries with a model, then “6 of 10” means her page answers six of the tool’s own suggestions. That is a fine starting point for editing. It is not a measurement of her visibility.</p><p>Ask the vendor for one sample export that shows where each query came from. If they cannot show you, treat the list as brainstorming.</p><h3>Question 2: What is the denominator?</h3><p>The denominator is the bottom number in the fraction. In “6 of 10,” it is the 10.</p><p>The percentage only means something if you know what the 10 represents and why those ten were chosen.</p><p>Some things worth asking:</p><ul><li>Which AI product was sampled? ChatGPT, Google AI Mode and Perplexity behave differently.</li><li>Were the sessions logged in or logged out? Free or paid?</li><li>How many times was each question asked?</li><li>Was the list fixed before the page was checked, or adjusted afterward?</li></ul><p>That last point is easy to miss. If a list can be swapped out after the fact, the score can rise just because harder questions were dropped.</p><p>Ahrefs offers a good example of why sampling details matter. Its October 2026 study looked at 66.6 million responses from free, logged-out sessions of GPT-5.6 Luna in August and September 2026. It found fan-out queries in 14.4% of those responses.</p><p>Ahrefs notes that free, logged-out sessions search less than paid or reasoning models. It also used broad prompts, rather than the “best X near me” style prompts that buyers type. And Ahrefs later corrected its own wording, from “14.4% searched the web” to “14.4% contained fan-out queries.”</p><p>That is one careful study being clear about its limits. A coverage score in a dashboard deserves the same level of detail.</p><h3>Question 3: What does “covered” mean?</h3><p>A tool might mark a query as covered if the page contains certain words. Another might use a model to judge whether the page “answers” the question.</p><p>Neither tells you whether a reader with that question would walk away satisfied.</p><p>There is also a second gap. Even if the queries are real, OpenAI’s documentation separates sources a model consulted from sources it cited in the answer. A page can be read and still not be cited. A coverage score usually cannot tell you which of those happened.</p><p>And nothing in the public record we reviewed shows that raising a coverage score leads to more AI citations. Google’s own AI features guidance says there are no special optimizations needed to appear in AI Overviews or AI Mode beyond normal search basics.</p><h3>What Dana should do instead</h3><p>The score is not useless. It handed Dana four questions worth thinking about. The trick is to treat them as questions to review, one at a time, instead of gaps to fill.</p><p>Here is how we would walk through her list.</p><p><strong>Tap water.</strong> This is a real problem for people keeping a starter alive. Chlorinated water can slow some starters down. Dana answers this question at her class almost every weekend. It belongs on the page, in a short section near the feeding instructions.</p><p><strong>Nail polish smell.</strong> This is a classic sign of a hungry starter. Someone searching it is in the middle of the exact task the page covers. Dana adds two sentences and a note on how to fix it.</p><p><strong>Best flour.</strong> This one is bigger than it looks. A real answer involves protein content, whole grain versus white, and what local mills sell. That could swamp the page. Dana writes a short line on the page and plans a separate article about flour, linked from the original.</p><p><strong>Starter vs commercial yeast.</strong> People asking this are deciding whether to start sourdough at all. Dana’s page is for people who already have a starter. This question serves a different reader, so it does not go on this page.</p><p>After her edits, the tool might say 8 of 10, or it might say something else. Dana does not need to care much either way.</p><p>What matters is that someone with a struggling starter can now solve their problem on her page, and that she can point to her own class experience as the source for her answers.</p><h3>A short checklist before you trust any coverage score</h3><ul><li>Ask where every query came from: returned by an interface, observed, or generated.</li><li>Ask which AI product, account type and date range the queries came from.</li><li>Ask whether the list was fixed before your page was checked.</li><li>Ask how the tool decides that a query is “covered.”</li><li>Read each missing question yourself and decide whether your reader needs it on this page.</li><li>Keep a copy of the page before and after your edit, with the date, so you can compare later.</li></ul><p>If a vendor cannot explain the source and the denominator, set the number aside and read the questions.</p><h3>Where this leaves small businesses</h3><p>Fan-out is real. Google documents it, OpenAI and Perplexity expose parts of it to developers, and Ahrefs measured it in a large sample from one model.</p><p>What no public source shows is a reliable way for an outside tool to see every search an AI system runs for your customers, or a proven link between covering those searches and getting cited.</p><p>For a bakery owner, a plumber or a solo consultant, that is good news in a way. You do not need a perfect score. You need pages that fully answer the questions your customers actually bring to you, written from the experience only you have.</p><p>We wrote up the full source review on the outwrite.ai research page, including all seven documents we inspected.</p><p><strong>Sources</strong></p><ul><li><a href="https://developers.google.com/search/docs/appearance/ai-features">Google Search Central, AI features and your website</a></li><li><a href="https://developers.openai.com/api/docs/guides/tools-web-search">OpenAI, Web search</a></li><li><a href="https://docs.perplexity.ai/docs/agent-api/quickstart">Perplexity, Agent API quickstart</a></li><li><a href="https://ahrefs.com/blog/query-fan-out-chatgpt/">Ahrefs, How ChatGPT Does Query Fan-Out (October 12, 2026)</a></li><li><a href="https://outwrite.ai/research/query-fan-out-evidence">outwrite.ai, Query Fan-Out: What You Can Actually Observe</a></li></ul><p><em>Two Rivers Bread Co. is a fictional business used for illustration.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=842d489d62b0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Counting translated pages hides the tasks your readers can’t finish]]></title>
            <link>https://medium.com/@jameson_64305/counting-translated-pages-hides-the-tasks-your-readers-cant-finish-8c9b99d9da57?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/8c9b99d9da57</guid>
            <category><![CDATA[product-management]]></category>
            <category><![CDATA[documentation]]></category>
            <category><![CDATA[localization]]></category>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[saas]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Fri, 06 Nov 2026 15:45:17 GMT</pubDate>
            <atom:updated>2026-11-06T15:45:17.658Z</atom:updated>
            <content:encoded><![CDATA[<h4>A practical way to measure localized documentation by the jobs people come to do, with a worked example and a release check you can copy.</h4><p>Ask a team how their localized docs are doing and you’ll usually get a percentage.</p><p>“French is at 80%.”</p><p>That number almost always means pages. Eighty of a hundred pages have a French version. It’s easy to count, and it goes up every time someone publishes something.</p><p>It also tells you very little about whether a French-speaking customer can set up your product.</p><p>We looked at this question in a new Docsio Research report on translated documentation. This piece pulls out the measurement side of it: what to count, how to count it, and how to check a release before readers find the gaps for you.</p><h3>Start with tasks</h3><p>A reader rarely arrives wanting “page 47.” They arrive wanting to connect an account, rotate an API key, or invite a teammate.</p><p>So the first step is a short list of essential tasks. These are the jobs a new or paying customer has to be able to finish without contacting you. Keep it short enough that someone can name every item from memory.</p><p>Then, for each language, you ask one question per task: has a person reviewed the translated version of this task against the current source, for the release customers are on?</p><p>Here’s the illustrative example from the report. A docs site has 100 pages. Eighty have French versions, so page coverage is 80%. The site has 10 essential tasks. Six have reviewed French versions, so task coverage is 60%.</p><p>The gap between 80 and 60 is where readers get stuck. Those four unreviewed tasks might be your most visited pages.</p><p>The report makes one recommendation about this that we’d underline: keep the two denominators separate. If they get blended into one score, the dashboard starts rewarding teams for publishing unverified pages.</p><h3>Five measures worth tracking</h3><p>Task coverage is the first of five measures the report proposes. Each one answers a different question.</p><ol><li><strong>Reviewed task coverage.</strong> Named tasks reviewed for the release that matters. Use it to decide which customer paths to translate or review next.</li><li><strong>Consequential changes awaiting review.</strong> Source changes that affect what a reader does, grouped by how serious the effect is. Use it to decide when a correction should interrupt routine work.</li><li><strong>Review lag.</strong> Time from a source change to its review, split by severity. A typo can wait a week. A new required permission probably can’t. This measure shows whether you’re meeting your own targets.</li><li><strong>Fallback use.</strong> How often a reader was offered another language because a translation was missing or suspended, and how often they took it. It shows where readers hit gaps. A click on the fallback doesn’t prove the fallback worked, so treat it as a signal.</li><li><strong>Observed task completion.</strong> Whether real people finish a task, recorded with their language ability, the task, the release and what counted as success. This is the slowest to collect and the most direct evidence you’ll get.</li></ol><p>None of these require special tooling to start. A spreadsheet with one row per task per language gets you the first three.</p><h3>A worked example: the connection guide</h3><p>The report uses a fictional analytics product with a guide called “Connect your reporting account.” It’s a useful case because the change looks small.</p><p>The English source moves from revision A to revision B. Revision B adds one prerequisite: a workspace owner now has to approve the connection. It also changes the confirmation screen.</p><p>The French translation was reviewed against revision A. It still says any member can complete the connection.</p><p>Walk through what each measure shows on the day revision B ships.</p><p>Page coverage doesn’t move. The French page still exists, so it still counts.</p><p>Task coverage drops by one. “Connect your reporting account” no longer has a French version reviewed against the current source.</p><p>Consequential changes awaiting review goes up by one, and it’s classed as serious. A missing prerequisite means some readers will fail.</p><p>Review lag starts counting from the moment revision B was published.</p><p>Fallback use and observed completion will tell you, over the next few days, how many French readers are hitting the problem.</p><p>If the dashboard only showed page coverage, everything would look fine. Members without owner rights would be getting an unexplained failure the whole time.</p><p>The report suggests two acceptable responses. The better one is a reviewed French correction that adds the prerequisite and updates the screen reference. If that can’t happen quickly, remove the misleading claim and offer the current English guide, with a clear note about what language it’s in.</p><h3>Sorting changes by effect</h3><p>The review queue only works if changes are classified by what they do to the reader. The report’s scale runs from a typo, which changes nothing about the action, up to a new warning on a destructive step, where the outdated instructions should be suspended.</p><p>When someone publishes a source change, they should record which of those it is. That one field drives the queue, the lag measure and whether readers need a notice.</p><h3>A release check you can copy</h3><p>The report closes with a release check. Here’s our condensed version for a small team.</p><p><strong>Before publishing a source change</strong></p><ul><li>List the translated tasks it affects.</li><li>Give each affected task an owner.</li><li>Record whether the change alters actions, prerequisites, examples, screenshots, or only wording.</li></ul><p><strong>Before publishing a translation</strong></p><ul><li>Check it in the real page layout. Look for wrapped button labels and tables that no longer fit.</li><li>Copy every command and run it. Translation tools sometimes swap straight quotes for typographic ones or change punctuation inside code.</li><li>Confirm product labels, links and expected outputs match the release.</li><li>For right-to-left languages, have a target-language reviewer check mixed-direction text like file paths and identifiers.</li></ul><p><strong>Accessibility</strong></p><ul><li>Status is conveyed in text, not just color.</li><li>Notices sit before the instruction they affect.</li><li>Language controls work with a keyboard.</li></ul><p><strong>Reader routes to test</strong></p><ul><li>A shared URL opened cold</li><li>A search result that lands halfway down the page</li><li>Switching language while viewing an older release</li><li>Choosing a language that has no current page for this task</li><li>The status notice on a narrow phone screen</li></ul><p><strong>Closing the change</strong></p><ul><li>Mark it done only when the public page matches the review record.</li><li>When a translation is restored, remove the temporary notice and test the fallback routes again.</li></ul><h3>What this doesn’t prove</h3><p>The five measures and the release check are proposals. The report says plainly that they haven’t been validated across languages or products, and the 80/60 figures are illustrative.</p><p>What they do give you is a way to see the problem the page count hides. That’s usually enough to change what the team works on next week.</p><p>If you don’t have a docs site yet, you can paste your product’s URL at docsio.co and have a branded one to work from in about 30 seconds. Then write your task list before your first translation.</p><p>The full report, with sources from Kubernetes, MDN, the W3C and Google Search Central, is here: <a href="https://docsio.co/research/translated-documentation-freshness">https://docsio.co/research/translated-documentation-freshness</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8c9b99d9da57" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Credit Unions Want Fintech Partners. Their Projects Keep Running Late.]]></title>
            <link>https://medium.com/@jameson_64305/credit-unions-want-fintech-partners-their-projects-keep-running-late-0ed622896bd5?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/0ed622896bd5</guid>
            <category><![CDATA[fintech]]></category>
            <category><![CDATA[credit-unions]]></category>
            <category><![CDATA[banking]]></category>
            <category><![CDATA[partnerships]]></category>
            <category><![CDATA[b2b-marketing]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Fri, 06 Nov 2026 15:35:25 GMT</pubDate>
            <atom:updated>2026-11-06T15:35:25.756Z</atom:updated>
            <content:encoded><![CDATA[<p>New PYMNTS and Velera data shows where credit union and fintech projects slip, and what fintech marketers can do about it before a contract is signed.</p><p>Almost every credit union in the U.S. now works with outside technology partners.</p><p>That part of the story is settled. What is less talked about is how often those partnerships take longer than anyone planned, and how that delay shapes the way fintechs should market to credit unions in the first place.</p><p>We spend a lot of time running lead programs for fintech and payments companies. The question we hear most from their marketing teams is some version of “why is this taking so long?” A credit union downloads a guide, shows real interest, and then the deal sits for months.</p><p>The 2026 research from PYMNTS Intelligence and Velera gives a pretty direct answer. Here is what it says, and what we think it means for fintech marketing.</p><h3>Partnerships are now the default for credit unions</h3><p>PYMNTS and Velera publish a recurring study called the Credit Union Innovation Readiness Index. In the edition covered by PYMNTS on March 5, 2026, only 0.6% of credit unions said they could fully innovate without outside support.</p><p>Roughly 9 in 10 credit unions collaborate with at least one external partner. The types of partners break down like this:</p><ul><li>CUSOs and cooperative networks: 51.8%</li><li>Fintech or technology providers: 47.2%</li><li>Core or digital banking providers: 39.2%</li></ul><p>Size matters a lot here. Only 12% of credit unions under $500 million in assets build bespoke innovations themselves. Among the largest credit unions, that share is 63%.</p><p>For a fintech, that split is useful to know. Smaller credit unions lean heavily on partners because they lack the internal teams to build. Larger ones have more options and more internal opinions to manage.</p><h3>Most projects take longer than planned</h3><p>This is the number that stood out to us. In the same index, 77% of credit unions said their most recent innovation took longer than planned.</p><p>The fintechs in the study tell a matching story:</p><ul><li>22% said their projects met the planned timeline</li><li>0% finished ahead of schedule</li><li>12% reported significant delays, rising to 25% among the largest fintech providers</li></ul><p>Zero percent finished early. If you sell to credit unions, it is safe to plan for your project running long.</p><p>The delay also shows up in expectations. Among credit unions the study calls “Laggards,” 57% expect projects to last one to two years, and 28% expect more than two years.</p><h3>Return on investment depends on who you sell to</h3><p>The index sorts credit unions into groups based on how they approach innovation. “Early Launchers” move quickly. “Laggards” move slowly.</p><p>The ROI gap between them is wide:</p><ul><li>30.8% of Early Launchers say they fully achieved ROI from their latest project</li><li>6.3% of Laggards say the same</li><li>21.9% of Laggards have not achieved ROI yet, compared with 15.4% of Early Launchers</li></ul><p>Fintechs see it from their side too. Only 16% report fully achieving ROI on credit union projects, while 72% say ROI is partially achieved.</p><p>When most projects end up “partially” successful, the credit union’s next buying decision gets more cautious. That caution carries into every new vendor conversation.</p><h3>Where the friction comes from</h3><p>Both sides in the study were asked what gets in the way.</p><p>Fintechs pointed at the credit union. 88% cited credit union decision-making complexity, and 82% cited legacy system constraints.</p><p>Credit unions pointed back. 92.9% cited partner limitations around technical or regulatory flexibility, and 77.2% cited communication delays.</p><p>A separate PYMNTS piece from March 31, 2026, drawing on the same research partnership, added more detail. 64% of credit unions cited misalignment in goals or culture with fintech partners. 59% cited their own internal decision-making complexity. And 61% said faster implementation is a main reason they partner at all.</p><p>So credit unions partner with fintechs to move faster. Then the partnership itself turns out to be slow. Both sides see the problem, and each tends to locate it on the other side of the table.</p><h3>Fintechs are still coming</h3><p>None of this is slowing interest. A September 2026 PYMNTS Intelligence and Velera report, <em>FinTechs Want In: How Credit Unions Can Turn Partnerships Into Growth</em>, looked at fintechs that do not yet sell to credit unions.</p><p>48% said they are very or extremely likely to start selling to credit unions within three years. In November 2023, that figure was 4%. Including fintechs who are “somewhat likely,” 74% are open to entering the market.</p><p>The same report found two other things worth noting:</p><ul><li>50% of fintechs said credit union infrastructure is not suited to new technology</li><li>36% cited credit union budget constraints, which ranked lower than other barriers</li></ul><p>And among hesitant fintechs, 58% said a bundled, one-time onboarding process would make them more likely to partner. That share was 21% in November 2024.</p><p>Put simply, more fintechs are lining up to sell to credit unions, and the main thing holding them back is the work of getting set up. Budget ranks lower on the list.</p><h3>What credit unions are spending on</h3><p>Cornerstone Advisors’ <em>What’s Going On in Banking 2026</em> report gives a sense of where credit union attention is going right now.</p><p>Roughly 50% of credit unions and 40% of banks reported higher fraud losses in 2025. First-party fraud made up more than 40% of total fraud losses. About three-quarters of institutions are increasing fraud prevention budgets.</p><p>On the technology side, 59% of credit unions have deployed generative AI, compared with 49% of banks. Agentic AI has come up at the executive or board level at more than half of institutions.</p><p>Fraud and AI are the two topics with budget behind them. A fintech with a credible story in either area has a reason to get a meeting.</p><h3>What this means for fintech marketing</h3><p>Here is how we read all of this when we plan programs for fintech clients.</p><p><strong>Market the implementation, early.</strong> Credit unions have learned that projects run late. A content asset that shows a realistic implementation timeline, with the steps the credit union’s own team will own, answers the question they are already worried about. Expect this kind of asset to pull fewer downloads than a broad trend report. The people who do download it are usually further along.</p><p><strong>Write for the partner-light credit union.</strong> Only 12% of credit unions under $500 million in assets build their own innovations, so many of your buyers have small IT teams. Content that explains what you handle and what they handle is more useful to them than feature lists.</p><p><strong>Show how onboarding works.</strong> With 58% of hesitant fintechs asking for simpler onboarding, it is fair to assume credit unions feel the same pain from their side. A short guide to what onboarding with your company looks like (documents, timeline, who is involved) lowers the perceived cost of saying yes.</p><p><strong>Expect a long nurture.</strong> When 0% of projects finish early and many credit unions expect one to two years, the gap between first download and signed contract will be long. Leads from a credit union program should be routed into nurture with that timeline in mind, rather than judged on 30-day conversion.</p><p><strong>Ask about stage on the form.</strong> A single question such as “when do you need this live?” or “have you started a vendor review?” tells sales which leads to call this month and which to nurture for next year.</p><p><strong>Segment by size.</strong> The research shows big differences between small and large credit unions in how they build and how they buy. Running one campaign to all credit unions blends those signals together.</p><h3>Where we fit</h3><p>We run content syndication programs for fintech and payments companies, with verified leads and custom qualifying questions on every form. For credit union programs, that usually means pairing an implementation-focused asset with a question about timing, so the leads come in already sorted by how soon they can move.</p><p>The research makes one thing clear. Credit unions are going to keep partnering, and fintechs are going to keep coming. The vendors who win will likely be the ones whose content prepares the credit union for the whole project, from onboarding through go-live.</p><h3>Sources</h3><ul><li>PYMNTS, <a href="https://www.pymnts.com/?p=3532736">The Credit Union-FinTech Romance Continues, Even as Execution Gets Harder</a>, March 5, 2026</li><li>PYMNTS, <a href="https://www.pymnts.com/partnerships/2026/credit-unions-want-fintechs-on-speed-dial/">Credit Unions Want FinTechs on Speed Dial</a>, March 31, 2026</li><li>PYMNTS, <a href="https://www.pymnts.com/?p=4305950">Credit Unions Could Land More FinTech Partners by Simplifying Onboarding</a>, October 14, 2026</li><li>Cornerstone Advisors, <a href="https://www.crnrstone.com/press-release/cornerstone-advisors-whats-going-on-in-banking-research-finds-ai-crypto-and-fraud-are-top-of-mind-for-banking-executives-in-2026">What’s Going On in Banking 2026 press release</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=0ed622896bd5" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[What Journalists Want From Company Research in 2026]]></title>
            <link>https://medium.com/@jameson_64305/what-journalists-want-from-company-research-in-2026-4db2af4ccd39?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/4db2af4ccd39</guid>
            <category><![CDATA[public-relations]]></category>
            <category><![CDATA[content-marketing]]></category>
            <category><![CDATA[b2b-marketing]]></category>
            <category><![CDATA[journalism]]></category>
            <category><![CDATA[market-research]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Thu, 05 Nov 2026 16:10:18 GMT</pubDate>
            <atom:updated>2026-11-05T16:10:18.056Z</atom:updated>
            <content:encoded><![CDATA[<p>Two newsroom surveys from this year show what gets a vendor’s data into a story, and what gets a pitch deleted.</p><p>Two of the largest journalist surveys of 2026 came out this spring.</p><p>One is from Cision. The other is from Muck Rack. Together they cover thousands of reporters and editors across North America, Europe and Asia Pacific.</p><p>Both point in the same direction. Journalists still lean on PR for ideas. They want data and people to interview. And most of what lands in their inbox misses the mark.</p><p>For any B2B company that publishes its own research, these numbers say a lot about how that research should reach the press.</p><h3>What the Cision survey found</h3><p>Cision’s 2026 State of the Media Report surveyed 1,899 journalists in 19 markets during January and February 2026. Cision published the results on May 13.</p><p>66% of journalists said they rely on PR-provided content, such as press releases, pitches and media kits, for story ideas.</p><p>When asked what they value most in a pitch, journalists named original research, access to experts and embargoed information. Cision also listed credible data among the things reporters want.</p><p>The less encouraging number: 72% of journalists said fewer than a quarter of the pitches they receive are relevant to them.</p><p>So the door is open. Most people knocking on it are at the wrong address.</p><h3>What the Muck Rack survey found</h3><p>Muck Rack’s State of Journalism 2026 was fielded from January 30 to March 2, 2026.</p><p>86% of journalists said at least some of their stories started with a PR pitch.</p><p>Muck Rack also asked which pitch elements journalists value most. The top four:</p><ul><li>Clear relevance to their beat: 70%</li><li>Access to relevant interview sources: 58%</li><li>Original data or research: 40%</li><li>High-resolution images: 37%</li></ul><p>On format, 69% of journalists prefer pitches under 200 words, and 78% prefer to receive them before noon. 43% said relevant pitches to their beat are rare.</p><h3>Reading the two surveys together</h3><p>Original research shows up near the top of both lists. In Muck Rack’s ranking it sits behind beat relevance and interview access.</p><p>That ordering matters. A strong dataset sent to the wrong reporter still gets ignored. The same dataset, cut for that reporter’s beat and offered with someone to interview, covers the three things journalists say they want most.</p><p>For a company that has run a survey, that usually means preparing several versions of the findings instead of one.</p><p>A reporter covering healthcare IT wants the hospital respondents. A reporter covering manufacturing wants the plant engineers. A trade editor covering procurement wants the procurement data. The full report stays the same. The pitch changes.</p><h3>A pitch checklist for company research</h3><p>Based on what the two surveys report, a research pitch has the best odds when it does these things:</p><ol><li><strong>Opens with one number.</strong> The headline finding goes in the first line.</li><li><strong>Matches the beat.</strong> Each outlet gets the cut of the data that fits what it covers.</li><li><strong>Shows the method.</strong> Sample size, field dates, who answered and who paid for the study, in one short paragraph.</li><li><strong>Offers a person.</strong> Name the analyst or executive available for an interview.</li><li><strong>Stays under 200 words.</strong> Link to the rest.</li><li><strong>Arrives before noon.</strong> In the reporter’s time zone.</li><li><strong>Includes a chart.</strong> A clean, high-resolution image of the key finding.</li><li><strong>Points to an open page.</strong> Headline findings on an ungated page give reporters something to cite and link.</li></ol><h3>Why press coverage carries into AI answers</h3><p>There is a second reason to care about editorial pickups in 2026.</p><p>Tools like ChatGPT, Perplexity and Google’s AI Overviews often cite third-party sites when they answer questions. A finding that only lives on a company’s own blog has one source behind it. A finding republished across trade and news sites has many.</p><p>Each pickup puts the company name and its data on an independent domain. Those pages become sources AI tools can quote when a buyer asks about the topic months later.</p><p>We have published separate research on how <a href="https://lead-spot.net/research/third-party-ai-citations-content-syndication/">third-party AI citations relate to content syndication</a>.</p><h3>Pitching one reporter at a time has limits</h3><p>The surveys describe the one-to-one pitch: a PR person, a reporter, a story. That still works when the fit is right.</p><p>It is also slow. Even a well-targeted research pitch reaches a handful of outlets.</p><p>Editorial syndication takes a different route. Headline findings are written as a news-style article and republished across a network of licensed publishers.</p><p>LeadSpot’s editorial syndication launches this month with licensed access to more than 3,000 editorial and news publishers. Campaigns typically earn 150 to 250 pickups.</p><p>Those two approaches work well together. Targeted pitches earn original coverage from reporters who want an interview. Syndicated pickups widen the footprint of the same findings across many more sites.</p><h3>What to take from this year’s numbers</h3><p>Journalists are open to company research. Two-thirds use PR content for story ideas, and most have written stories that began with a pitch.</p><p>They are also overloaded with pitches that don’t fit. The research that gets used is cut for the right beat, kept short and paired with a real person to interview.</p><p>If you are planning a study for 2027, plan the press versions at the same time as the questionnaire. It is much easier to collect the industry and role splits up front than to wish for them later.</p><p>The full LeadSpot research on using original research in syndication is here: <a href="https://lead-spot.net/research/why-original-research-makes-the-best-syndication-content/">Why Original Research Makes the Best Syndication Content</a>.</p><p><strong>Sources:</strong> <a href="https://www.cision.com/about/press-releases/2026-press-releases/pr-emerges-as-the-primary-source-for-journalists-in-high-pressure-newsrooms-302770936/">Cision 2026 State of the Media Report press release</a> · <a href="https://umarcomm.umn.edu/blog/2026/04/13/pitching-journalists-muck-racks-state-journalism-2026">University of Minnesota summary of Muck Rack’s State of Journalism 2026</a> · <a href="https://muckrack.com/stateofjournalism/">Muck Rack State of Journalism 2026</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4db2af4ccd39" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Your Old Blog Post Lost Traffic. Run These Checks Before You Rewrite It.]]></title>
            <link>https://medium.com/@jameson_64305/your-old-blog-post-lost-traffic-run-these-checks-before-you-rewrite-it-bddfa6bef680?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/bddfa6bef680</guid>
            <category><![CDATA[small-business]]></category>
            <category><![CDATA[content-marketing]]></category>
            <category><![CDATA[google]]></category>
            <category><![CDATA[blogging]]></category>
            <category><![CDATA[seo]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Thu, 05 Nov 2026 15:55:08 GMT</pubDate>
            <atom:updated>2026-11-05T15:55:08.321Z</atom:updated>
            <content:encoded><![CDATA[<h4>A plain-language walk through Google’s traffic drop guide, using a small repair shop as the example.</h4><p>Here is a situation we hear about a lot.</p><p>A small business owner opens Google Search Console, sees that one of their best blog posts has fewer clicks than it used to, and decides it needs a rewrite. They spend a weekend on it. New intro, new headings, a few extra sections, a fresh date at the top.</p><p>Sometimes that was the right call. Often the post was fine, and the drop had a cause that a rewrite could never fix.</p><p>Google publishes a guide on exactly this: <a href="https://developers.google.com/search/docs/monitor-debug/debugging-search-traffic-drops">debugging drops in Google Search traffic</a>. It lists the common causes and the checks to run. We think it is one of the most useful pages a founder can read, and very few people read it.</p><p>This article walks through it step by step, using a made-up business so the steps feel concrete.</p><h3>Meet the example business</h3><p>Cedar Row Bike Repair is a fictional two-person shop in Duluth, Minnesota.</p><p>In 2024, the owner wrote a post called “How to get your bike ready for a Minnesota winter.” It covers cleaning the chain, switching to studded tires, and storing a bike in an unheated garage. It became the shop’s top page for organic search, and a steady source of tune-up bookings.</p><p>In April, the owner notices clicks to that post are down about 70% compared with January. The instinct is to rewrite it.</p><p>Before touching it, here is what the guide says to check.</p><h3>Step 1: Compare the right periods</h3><p>The first instruction in Google’s guide is to look at a longer window. In the Search Console performance report, it says to “choose the Date filter on top of the chart and select Last 16 months.”</p><p>Sixteen months matters because it lets you compare the same season across two years.</p><p>The guide is direct about this: “make sure it’s not a drop that happens every year due to a festivity or a trend.” It also notes that “changes in user behavior will change the demand for certain queries.”</p><p>For Cedar Row, the 16-month view shows the same shape last year. Clicks climbed from October to January and fell off in spring. Nobody in Duluth searches for winter bike prep in April.</p><p>That single check answers the question. The post did not get worse. Demand moved with the weather.</p><p>A rewrite in April would have changed a page that was doing its job, and the owner would have had no way to tell whether the edit helped or hurt when traffic came back in the fall.</p><h3>Step 2: Check which searches moved</h3><p>Suppose the 16-month view had shown something different: a drop this spring that did not happen last spring. The next step is to narrow it down.</p><p>Google’s guide says to “click all tabs to find out if the change happened only for specific queries.” The performance report has tabs for queries, pages, countries, devices and search appearance. The guide also suggests trying the different search type options (web, image, video, news) and sorting by “Clicks Difference” to see which pages lost the most traffic.</p><p>This tells you whether the drop is about one post, one type of search, or the whole site. Those are very different problems.</p><p>Two things to keep in mind when reading these reports, both noted in our <a href="https://outwrite.ai/research/content-refresh-evidence">research review on content refreshes</a>:</p><ul><li>Search Console leaves some queries out of the query table to protect searcher privacy. The page totals can be higher than the sum of the queries you can see.</li><li>Performance data is credited to the canonical URL, which is the version of a page Google treats as the main one. If Google started treating a different URL as canonical, clicks can appear to move away from the page you are watching.</li></ul><h3>Step 3: Rule out technical problems</h3><p>Google’s guide lists technical issues as a cause in their own category. Its examples include server errors, problems fetching robots.txt, “page not found” errors, and a misplaced noindex tag. A noindex tag is a line of code that tells search engines to leave a page out of results.</p><p>The guide adds that page-level problems usually cause a slower decline than site-wide ones.</p><p>For a small business site, the realistic version of this check is short:</p><ol><li>Open the post in a private browser window and confirm it loads.</li><li>Run the URL through the URL Inspection tool in Search Console and confirm it is indexed.</li><li>Ask whoever manages the site whether anything changed recently: a theme update, a plugin, a new SEO setting, a URL change.</li></ol><p>A lot of mystery drops on small sites trace back to step 3. A plugin update flips a setting, or a page gets moved and the old URL never gets redirected.</p><p>None of those are content problems. Rewriting the post would leave the actual fault in place.</p><h3>Step 4: Look at the other causes on Google’s list</h3><p>The guide names several more causes:</p><ul><li><strong>Algorithmic updates.</strong> Google says “small fluctuations in position can happen at any time.” Large drops after a core update may call for a broader review of the site, not one page.</li><li><strong>Security issues.</strong> Malware or phishing can trigger browser warnings that stop visitors before they reach you. Search Console has a Security Issues report.</li><li><strong>Spam issues and manual actions.</strong> These show up in Search Console’s Manual Actions report.</li><li><strong>Site moves and migrations.</strong> Google says fluctuations after URL changes can last while it recrawls the site, which can take weeks or longer.</li><li><strong>Data issues.</strong> Reporting glitches can look like drops. Google keeps a Data Anomalies page listing known problems with its own numbers.</li></ul><p>Each of these takes a few minutes to check. Together they cover most of the drops that have nothing to do with the words on the page.</p><h3>Step 5: Decide whether the post has a reader problem</h3><p>If you have worked through steps 1 to 4 and still cannot explain the drop, it is time to read the post itself. Read it the way a customer would.</p><p>The question to ask: is there something in this post that is wrong, missing or harder to use than it should be?</p><p>For Cedar Row, that might look like:</p><ul><li>The post recommends a tire model the shop no longer stocks.</li><li>It lists a winter tune-up price from 2024.</li><li>A customer asked about e-bike batteries in the cold, and the post does not mention them.</li></ul><p>Those are real reasons to edit. Each one is a specific fact a reader would notice.</p><p>Our research review puts it this way: a refresh needs a specific correction, such as a wrong price, an outdated setting, or a central question the page does not answer. An old date on its own is not one of those.</p><p>If nothing is wrong and the drop has an explanation, Google’s own guide supports leaving it alone. It says “we recommend avoiding making radical changes if your page is already performing well.”</p><h3>Step 6: Write down what you expect before you edit</h3><p>This is the step almost everyone skips.</p><p>Before changing the page, write two or three lines in a notes file:</p><ul><li>What you are fixing and why (“price is out of date, battery question unanswered”).</li><li>What you will compare afterward (“clicks to this URL, October to January, against last year’s October to January”).</li><li>What else is happening in that window that could affect the result (“new shop location opens in November”).</li></ul><p>Without this note, any change in traffic afterward is hard to read. Traffic might rise because of the edit, because of the season, or because of a Google update, and you will not be able to tell which.</p><p>It also helps to judge the edit on two separate questions. Did it fix the reader’s problem? And did search performance change? The first one you can confirm the day you publish. The second can take months and has many causes.</p><h3>Step 7: When you do edit, keep the signals honest</h3><p>If the post needs work, a few rules from Google’s documentation keep the update clean:</p><ul><li>Update the visible date only when the content has substantially changed. Google’s helpful content guidance lists changing dates “to make them seem fresh when the content has not substantially changed” as a warning sign.</li><li>Keep the same URL so the post keeps its history.</li><li>Fix every place the old fact appears, including image captions and screenshots.</li></ul><h3>A note on AI assistants</h3><p>Everything above comes from Google’s documentation and applies to Google Search.</p><p>ChatGPT, Perplexity and other AI assistants do not publish an equivalent troubleshooting guide. If you are tracking whether an AI assistant cites your post, record the question you asked, the date, the platform and the URL it cited. That gives you something to compare against later, and keeps one-off answers from looking like trends.</p><h3>The short version</h3><p>When an old post loses traffic, check the season first, then the searches that moved, then the technical setup, then the rest of Google’s list.</p><p>Edit when you can name what is wrong for the reader.</p><p>Write down what you expect before you publish.</p><p>For Cedar Row, the answer was to wait for October. For your post, the checks above will tell you.</p><p><em>This article draws on our research review, </em><a href="https://outwrite.ai/research/content-refresh-evidence"><em>When Is a Content Refresh Worth Doing?</em></a><em>, and on </em><a href="https://developers.google.com/search/docs/monitor-debug/debugging-search-traffic-drops"><em>Google’s guide to debugging search traffic drops</em></a><em>.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bddfa6bef680" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[The robots.txt Rule That Catches Small Business Sites]]></title>
            <link>https://medium.com/@jameson_64305/the-robots-txt-rule-that-catches-small-business-sites-dec9ed2074ff?source=rss-874e5799b53d------2</link>
            <guid isPermaLink="false">https://medium.com/p/dec9ed2074ff</guid>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[seo]]></category>
            <category><![CDATA[small-business]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <category><![CDATA[web-development]]></category>
            <dc:creator><![CDATA[Jameson Buckley]]></dc:creator>
            <pubDate>Wed, 04 Nov 2026 16:31:08 GMT</pubDate>
            <atom:updated>2026-11-04T16:31:08.520Z</atom:updated>
            <content:encoded><![CDATA[<h4>How crawlers read the file line by line, and why adding one friendly line can open a page you meant to keep closed.</h4><p>Most advice about robots.txt tells you which bot names to list.</p><p>Very little of it explains how a crawler reads the file once it arrives. That part decides what actually happens, and it follows a published standard, RFC 9309, that almost nobody outside of engineering has opened.</p><p>We read it so you don’t have to. Here’s how the rules work, walked through with one small business.</p><h3>Meet Harbor Lane</h3><p>Harbor Lane Tile &amp; Stone is a fictional tile shop in Portland, Maine. Two owners, one showroom, a website built on a template.</p><p>Their site has three kinds of pages:</p><ul><li>Public pages: services, a gallery of finished bathrooms, an FAQ about heated floors.</li><li>A trade pricing page at /trade-pricing/ for contractors who buy in volume.</li><li>A booking page for showroom visits.</li></ul><p>A few years ago someone added this to their robots.txt:</p><pre>User-agent: *<br>Disallow: /trade-pricing/</pre><p>The * means &quot;every crawler.&quot; The rule asks all of them to stay out of the trade pricing folder.</p><p>So far, so reasonable.</p><h3>The line they added this fall</h3><p>This year the owners read that ChatGPT search uses a crawler called OAI-SearchBot. OpenAI’s documentation says sites that opt out of OAI-SearchBot will not be shown in ChatGPT search answers.</p><p>They wanted to be found. So they added a welcome:</p><pre>User-agent: *<br>Disallow: /trade-pricing/</pre><pre>User-agent: OAI-SearchBot<br>Allow: /</pre><p>It looks like a small, friendly addition.</p><p>Here’s what it does under the standard: OAI-SearchBot is now allowed into /trade-pricing/.</p><h3>Why that happens</h3><p>RFC 9309 says a crawler looks for a group of rules that names it. If one exists, the crawler follows that group. The * group only applies when no group names the crawler.</p><p>The two groups do not stack. A crawler with its own group never reads the wildcard rules at all.</p><p>So once Harbor Lane gave OAI-SearchBot its own group, the Disallow: /trade-pricing/ line stopped applying to it. The only rule OAI-SearchBot sees is Allow: /.</p><p>We checked this with Python’s built-in robots.txt parser. Against the file above, OAI-SearchBot gets “allowed” for /trade-pricing/. GPTBot and ClaudeBot, which have no group of their own, still get &quot;disallowed.&quot;</p><p>The outwrite.ai research review published November 4 ran a larger version of this check: 18 local tests, nine agent strings against two paths, on a fictional file. The pattern is the same. Every named group has to carry its own restrictions.</p><h3>The fix for Harbor Lane</h3><p>Repeat the restriction in every named group:</p><pre>User-agent: *<br>Disallow: /trade-pricing/</pre><pre>User-agent: OAI-SearchBot<br>Disallow: /trade-pricing/<br>Allow: /</pre><p>Now the search crawler can read the gallery and the FAQ, and is still asked to skip the trade pricing.</p><p>If they later add groups for Claude-SearchBot or anyone else, each one needs the same line.</p><h3>Rule two: the longest path wins</h3><p>Inside a group, a page can match more than one rule.</p><p>Say Harbor Lane keeps a /guides/ folder of half-finished drafts, but wants one finished guide crawled:</p><pre>User-agent: *<br>Disallow: /guides/<br>Allow: /guides/heated-floors/</pre><p>RFC 9309 says the most specific match wins, and “most specific” means the rule with the most characters. /guides/heated-floors/ is longer than /guides/, so that guide is allowed while the rest of the folder stays disallowed.</p><p>If an Allow and a Disallow rule are equally long, the standard says the Allow rule should be used.</p><p>Order in the file does not decide this. Length does.</p><h3>Rule three: what happens when the file itself breaks</h3><p>This part surprises people.</p><p>RFC 9309 treats a missing file and a broken server very differently.</p><p>If yoursite.com/robots.txt returns a 4xx error (most often a 404, meaning the file isn&#39;t there), crawlers may access any page on the site. No file means no requests.</p><p>If it returns a 5xx error (the server is failing), crawlers must assume everything is disallowed.</p><p>So a host outage that breaks the robots.txt address can, for a while, read to compliant crawlers as “stay out of the whole site.” The standard says that if the file stays unreachable for a long time (it gives 30 days as an example), crawlers may treat it as missing or fall back to a cached copy.</p><h3>Rule four: changes are not instant</h3><p>The standard lets crawlers cache your robots.txt, and says they should not use a cached copy for more than 24 hours unless the file is unreachable.</p><p>OpenAI says changes for its search crawler can take about 24 hours to take effect after you update robots.txt.</p><p>If Harbor Lane fixes the file at 9 a.m., they should not expect a change in behavior before the next day. Plan edits with that lag in mind, especially before a launch.</p><h3>Rule five: some requests aren’t crawling</h3><p>robots.txt is written for automated crawlers. Some AI tools also fetch a page because a person asked them to.</p><p>OpenAI’s agent for this is ChatGPT-User. OpenAI says that because these actions are initiated by a user, robots.txt rules may not apply.</p><p>Anthropic documents a similar agent, Claude-User, and says blocking it prevents Claude from retrieving your content in response to a user query.</p><p>The two providers describe this differently, so it’s worth reading each one’s page instead of assuming they match.</p><h3>Rule six: the file is a public note</h3><p>Anyone can open yoursite.com/robots.txt in a browser. That includes competitors and curious customers.</p><p>RFC 9309 says its rules “are not a form of access authorization,” and notes that the paths listed in the file are publicly discoverable.</p><p>For Harbor Lane, this means the line Disallow: /trade-pricing/ tells every visitor where the contractor prices live. If those prices are meant for contractors only, the page needs a login or a password. robots.txt can ask polite crawlers to skip it. It cannot stop anyone from opening it.</p><h3>A 15-minute check for your own site</h3><ol><li>Open yoursite.com/robots.txt and copy it into a document.</li><li>List every User-agent line. Note which ones are named bots and whether there&#39;s a * group.</li><li>For each named group, check that it repeats every Disallow line from the * group that you still want to apply.</li><li>Look for any path in the file that you’d be uncomfortable with a stranger reading. Move that content behind a login.</li><li>Open the private pages in a private browser window while signed out. If they load, they’re public, whatever robots.txt says.</li><li>After any change, wait a day before checking crawler behavior in your server logs.</li></ol><p>None of this requires a developer for the diagnosis. The fixes are usually a few lines.</p><h3>Where outwrite.ai fits</h3><p>Getting the file right lets AI search crawlers read your public pages. It doesn’t decide whether those pages get cited.</p><p>That’s the part we built outwrite.ai for. It scans your domain, shows which AI answers name your competitors for the questions your buyers ask, and writes pages structured for those answers. The domain scan is free at outwrite.ai.</p><p>The provider-by-provider review that started this article is here: <a href="https://outwrite.ai/research/ai-search-crawlers-and-training-controls">AI Search Crawlers and Training Controls: What Publishers Can Choose</a>.</p><p><em>Harbor Lane Tile &amp; Stone is a fictional business used for illustration. Rules described here are from RFC 9309 and provider documentation read November 4, 2026. They describe how compliant crawlers are meant to behave, not measured crawler behavior.</em></p><p><strong>Sources</strong></p><ul><li><a href="https://www.rfc-editor.org/rfc/rfc9309.html">IETF RFC 9309: Robots Exclusion Protocol</a></li><li><a href="https://developers.openai.com/api/docs/bots">OpenAI: Overview of OpenAI crawlers</a></li><li><a href="https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler">Anthropic: Does Anthropic crawl data from the web?</a></li><li><a href="https://outwrite.ai/research/ai-search-crawlers-and-training-controls">outwrite.ai: AI Search Crawlers and Training Controls</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dec9ed2074ff" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>