Skip to content

fix(environments): correct search engine visibility scoping#5530

Draft
catplat wants to merge 6 commits into
mainfrom
fix/5529-search-engine-visibility-scoping
Draft

fix(environments): correct search engine visibility scoping#5530
catplat wants to merge 6 commits into
mainfrom
fix/5529-search-engine-visibility-scoping

Conversation

@catplat
Copy link
Copy Markdown
Collaborator

@catplat catplat commented Apr 8, 2026

Summary

Updates the search engine visibility documentation to reflect actual product behavior and improve clarity.

Factual corrections

  • Corrects the scoping of the Hide from search engines setting: behavior depends on project type (Grid vs Dedicated Gen 2), not just on whether a custom domain is assigned.
  • Splits the Grid behavior into distinct cases by environment type and custom domain presence, including a new/existing project distinction for production environments.
  • Adds a Dedicated Gen 2 section covering development environments (always hidden, enforced), staging environments (hidden by default, user can toggle), and production (always visible, enforced).
  • Removes incorrect prerequisites stating that a custom domain is required to toggle the setting (not true for Dedicated Gen 2 staging environments).
  • Removes the inaccurate footer "This setting can only be changed on environments with a custom domain."

Clarity improvements

  • Rewrites the intro to explain why hiding environments from search engines matters.
  • Updates the note about multiple-environment SEO risk to be project-type-agnostic.
  • Tab order: Console first, CLI second.
  • Console steps: simplified and de-scoped from production-only framing.
  • CLI: removed production-only lead-in; PRODUCTION_ENVIRONMENT_NAMEENVIRONMENT_NAME.
  • Caveat moved into a {{< note >}} block.
  • Section headings: "How it's done" → "How it works"; "Alternative method" → "Alternative method: Use a robots.txt file".
  • Last sentence of robots.txt section rewritten for clarity.

Related Issue

Closes #5529

Changes

  • sites/platform/src/environments/search-engine-visibility.md: All of the above.
  • sites/upsun/src/environments/search-engine-visibility.md: Clarity improvements only (Upsun Flex handles its own scoping via a separate PR).

Testing

Prose-only changes with no structural impact on shortcodes or links.

Issue: #5529 — fix(environments): correct search engine visibility scoping in docs

Changes:
- sites/platform/src/environments/search-engine-visibility.md: Replace "production environments with a custom domain" with "any environment with a custom domain" to reflect actual behavior
- sites/upsun/src/environments/search-engine-visibility.md: Same fix
…tual behavior

Issue: #5529 — fix(environments): correct search engine visibility scoping in docs

Changes:
- sites/platform/src/environments/search-engine-visibility.md: Rewrite intro, fix tab order (Console first), update Console steps to not scope to production, simplify CLI lead-in, move caveat into note block, rename sections, clarify last sentence
- sites/upsun/src/environments/search-engine-visibility.md: Same changes
@catplat
Copy link
Copy Markdown
Collaborator Author

catplat commented Apr 9, 2026

@nicogommen Are you able to review/approve/merge this?

Comment thread sites/platform/src/environments/search-engine-visibility.md Outdated
@catplat catplat requested a review from nicogommen April 22, 2026 21:31
catplat and others added 2 commits May 1, 2026 17:17
…ine visibility

Rewrites the behavior overview to reflect that visibility rules differ by
project type (Grid vs Dedicated Gen 2), not just by custom domain presence.
Adds separate bullet groups for each project type, removes incorrect
custom-domain prerequisites from the Console/CLI steps, and drops the
inaccurate footer in How it works.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@catplat catplat marked this pull request as draft May 1, 2026 22:09
@catplat catplat added the blocked label May 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

fix(environments): correct search engine visibility scoping in docs

2 participants