Conversation
Rename the tags: frontmatter to keywords: across all Cloud-to-Cloud source docs, preserving the existing values. GA4 shows the generated /help/docs/tags/* pages get ~99.7% bot traffic and 17 organic views total over 90 days, no SEO/GEO value, so the tags feature itself is being retired sitewide. The terms are still useful for search, so they move into keywords: instead of being dropped. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Drop the unused tags: [cloud soar integrations] frontmatter. Unlike the C2C source docs, this page had no pre-existing keywords: field and the single tag value isn't worth introducing one for, so it's just removed. Also includes an incidental trailing-whitespace fix on the Password bullet. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Remove tags: from the style guide's example frontmatter and the two scaffold templates (app-template-v2, c2c-source), renaming it to keywords: in the templates so new docs keep the same search terms without generating a tag page. Mark tags: as deprecated in the style guide's frontmatter parameter table so it isn't reintroduced. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Remove tags: from the docusaurus and sumo-style skill frontmatter examples, and rename tags to keywords in app-doc.md's required substitutions, checklist, and worked example so the /app-doc command matches the updated app-template-v2.md scaffold. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…p config Drop the Disallow: /tags/* and Disallow: /*?tags= rules from robots.txt, and /tags/** from the sitemap ignorePatterns, now that no tag routes exist to disallow or ignore. Note: this repo's robots.txt is served at /help/robots.txt, not the production domain root (https://www.sumologic.com/robots.txt, a separate WordPress-managed file that never included these rules), so this was cleanup rather than a fix to something that was blocking crawlers in production. The Algolia Crawler Admin's exclusionPatterns (external, not in this repo) also has two tags-related entries that are now no-ops; flagged separately for manual removal there. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
kimsauce
requested review from
JV0812,
amee-sumo and
mafsumo
as code owners
September 11, 2026 07:24
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose of this pull request
This pull request removes the unused Docusaurus tag taxonomy sitewide. GA4 shows the ~120 auto-generated
/help/docs/tags/*pages get almost no organic traffic and no established reader benefit, while costing ongoing upkeep (drift againstkeywords:, another thin crawl-surface URL per tag). See DOCS-1879 for the full rationale, including verified GA4 numbers and technical findings.Five commits, one per batch:
docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/):tags:renamed tokeywords:, values unchanged.zip-tools.md:tags:removed (no existingkeywords:field, single value not worth preserving).tags:guidance removed/deprecated so contributors don't reintroduce it; templates renamed tokeywords:to keep new docs consistent with (1)./app-doccommand): same treatment, so the doc-creation slash commands match the updated templates.robots.txt+ sitemap config: removed the now-obsoleteDisallow: /tags/*/Disallow: /*?tags=rules and the/tags/**sitemap-ignore entry.Verified with a clean local
yarn build: zerodocs-tags-*route artifacts generated, confirming the docs plugin stops generating tag routes once no doc hastags:frontmatter (there's no config flag for this — route generation is driven purely by frontmatter presence).Not in this repo, flagged separately: the Algolia Crawler Admin's
exclusionPatternshas two now-obsolete tag-related entries (harmless no-ops, not blocking) to remove manually in the Algolia dashboard.Select the type of change
Ticket (if applicable)
https://sumologic.atlassian.net/browse/DOCS-1879
🤖 Generated with Claude Code