Skip to content

Commit 551f9ba

Browse files
authored
[Docs guide] Section on content curation (#23736)
1 parent 706242c commit 551f9ba

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

src/content/docs/style-guide/how-we-docs/ai-consumability.mdx

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,3 +90,26 @@ For example, let's take a look at the amount of tokens required for the [Workers
9090
- index.md: 2,110 tokens (7.22x less than HTML)
9191

9292
When providing our content to AI, we can see a real-world ~7x saving in input tokens cost.
93+
94+
## Curating content
95+
96+
Other than the work making our content [discoverable](#ai-discoverability), most of the other work of making content for AI aligns with SEO or content best practices, such as:
97+
98+
- Using semantic HTML
99+
- Adding headings
100+
- Reducing inconsistencies in naming or outdated information
101+
102+
For more details, refer to [Google's AI guidance](https://developers.google.com/search/docs/appearance/ai-features#seo-best-practices).
103+
104+
### `noindex` directives
105+
106+
The only _special_ work we have done is adding a [`noindex` directives](https://developers.google.com/search/docs/crawling-indexing/block-indexing) to specific types of content (via a [frontmatter tag](/style-guide/frontmatter/custom-properties/#noindex)).
107+
108+
{/* prettier-ignore */}
109+
```html title="noindex meta tag"
110+
<meta name="robots" content="noindex">
111+
```
112+
113+
For example, we have certain pages that discuss deprecated features, such as [Wrangler 1](/workers/wrangler/migration/v1-to-v2/wrangler-legacy/). While technically accurate, they are no longer advisable to follow and could potentially confuse AI outputs.
114+
115+
At the moment, it's unclear whether all AI crawlers will respect these directives, but it's the only signal we have to exclude something from their indexing (and we do not want to set up [WAF](/waf/) rules for individual pages).

0 commit comments

Comments
 (0)