Skip to content

De-index /resources/ and merge the Docker container post into the Docker guide - #143

Merged
vpetersson merged 2 commits into
sbomify:masterfrom
vpetersson-bot:seo-consolidation-resources-docker
Aug 31, 2026
Merged

De-index /resources/ and merge the Docker container post into the Docker guide#143
vpetersson merged 2 commits into
sbomify:masterfrom
vpetersson-bot:seo-consolidation-resources-docker

Conversation

@vpetersson-bot

Copy link
Copy Markdown
Contributor

Two pages were competing with stronger pages for the same searches. This resolves both.

De-index /resources/

/resources/ was appearing in search results for tool-related queries and ranking well below the pages that should answer them, without adding anything of its own.

Rather than special-casing one page, this adds a reusable noindex frontmatter flag:

  • layouts/partials/head.html previously hardcoded index, follow into the robots and googlebot meta tags for every page, so there was no way to keep a page available to visitors while removing it from search results. The tags now honour the flag.
  • Adds layouts/sitemap.xml so flagged pages are omitted from the sitemap. It otherwise reproduces Hugo's default output.

/resources/ stays published, linked and reachable. All 44 internal links to it are unaffected. Sitemap goes from 345 to 344 URLs, the single removal being /resources/.

Merge the Docker container post into the Docker guide

/guides/docker/ and the September 2024 post How to generate an SBOM from a Docker container covered the same material.

The guide survives. It ranks better than the post, sits alongside the other language and platform guides, and has an evergreen URL rather than a dated one.

Carried over from the post:

  • A new "What Image Scanning Does and Does Not Capture" section covering why scanning an image misses binaries copied in during the build, why multi-stage builds compound the problem, and the recommendation to keep the container SBOM separate from the application SBOM. The guide had no equivalent caveat up front, and this is the post's most valuable content.
  • The docker sbom command for Docker Desktop, added to Alternative Tools.

The post's Trivy section is deliberately not carried over. Trivy was already removed from the guide's tool list after the March 2026 compromise.

The old post URL redirects to the guide via a Hugo alias, and the guide's Further Reading entry pointing at the post is removed.

Verification

  • hugo --minify --environment production builds clean
  • dprint check passes
  • Redirect stub at /2024/09/20/how-to-generate-an-sbom-from-a-container/ resolves to /guides/docker/
  • Old post URL is out of the sitemap; /guides/docker/ remains
  • /resources/ emits noindex, follow; other pages still emit index, follow
  • No remaining internal links to the removed post
  • d2 lint not run: not installed in this environment, and no .d2 files are touched

🤖 Generated with Claude Code

https://claude.ai/code/session_01Eb2uMFkkbVviAV9PBVikPj

vpetersson-bot and others added 2 commits August 31, 2026 21:11
Introduces a reusable `noindex` frontmatter flag. When set, a page emits
`noindex, follow` in its robots and googlebot meta tags and is omitted
from sitemap.xml.

The robots meta tags in head.html were previously hardcoded to
"index, follow" for every page, so there was no way to keep a page
available to visitors while removing it from search results.

Adds a sitemap template so the flag is honoured there too; it otherwise
reproduces Hugo's default output. Sitemap goes from 345 to 344 URLs,
the single removal being /resources/.

/resources/ remains published, linked, and reachable. It is excluded from
search indexing only, and the 44 internal links to it are unaffected.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Eb2uMFkkbVviAV9PBVikPj
/guides/docker/ and the September 2024 post "How to generate an SBOM from
a Docker container" covered the same ground and competed for the same
queries. Consolidates them into the guide.

The guide keeps the URL. It ranks better than the post, sits in the guides
section alongside the other language and platform guides, and carries an
evergreen URL rather than a dated one.

Carried over from the post:

- A new "What Image Scanning Does and Does Not Capture" section, covering
  why a container image scan misses binaries copied into the image, why
  multi-stage builds compound that, and the recommendation to keep the
  container SBOM separate from the application SBOM. The guide previously
  had no equivalent caveat up front.
- The `docker sbom` command for Docker Desktop, added to Alternative Tools.

The post's Trivy section is not carried over; Trivy was already removed
from the guide's tool list after the March 2026 compromise.

The old post URL redirects to the guide via a Hugo alias, and the guide's
Further Reading entry pointing at the post is removed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Eb2uMFkkbVviAV9PBVikPj
@vpetersson-bot
vpetersson-bot force-pushed the seo-consolidation-resources-docker branch from 6b631ed to 0439b5f Compare August 31, 2026 21:12
@vpetersson
vpetersson merged commit 7078521 into sbomify:master Aug 31, 2026
2 checks passed
@vpetersson-bot
vpetersson-bot deleted the seo-consolidation-resources-docker branch August 31, 2026 21:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants