Skip to content

Deprecate ingress-nginx docs, promote Gateway API#3105

Open
mcharriere wants to merge 5 commits into
mainfrom
deprecation-ic
Open

Deprecate ingress-nginx docs, promote Gateway API#3105
mcharriere wants to merge 5 commits into
mainfrom
deprecation-ic

Conversation

@mcharriere
Copy link
Copy Markdown
Contributor

Ingress NGINX is no longer offered by Giant Swarm. Archive the ingress
section by removing it from the navigation and adding deprecation notices
to each page pointing users to Gateway API with Envoy Gateway.

  • Add reusable notice shortcode for styled warning banners
  • Rewrite ingress/_index.md as a deprecation landing page (hidden from nav)
  • Remove menu entries from all four ingress sub-pages (hidden from nav)
  • Add deprecation notice to each sub-page body
  • Lower gateway-api section weight (25 → 15) to promote it in the nav

What this PR does / why we need it

Things to check/remember before submitting

  • If it's one of your first contributions, make sure you've read the Contributing Guidelines.
  • Bump last_review_date in the front matter header of the pages you've touched.

Ingress NGINX is no longer offered by Giant Swarm. Archive the ingress
section by removing it from the navigation and adding deprecation notices
to each page pointing users to Gateway API with Envoy Gateway.

- Add reusable `notice` shortcode for styled warning banners
- Rewrite ingress/_index.md as a deprecation landing page (hidden from nav)
- Remove menu entries from all four ingress sub-pages (hidden from nav)
- Add deprecation notice to each sub-page body
- Lower gateway-api section weight (25 → 15) to promote it in the nav
@mcharriere mcharriere requested a review from a team as a code owner May 12, 2026 09:13
@mcharriere
Copy link
Copy Markdown
Contributor Author

Screenshot 2026-05-12 at 10-35-38 Connectivity – Giant Swarm Documentation Screenshot 2026-05-12 at 11-12-45 Ingress connectivity (deprecated) – Giant Swarm Documentation Screenshot 2026-05-12 at 11-13-08 Advanced ingress configuration – Giant Swarm Documentation

- Replace NGINX with Nginx per project terms
- Use colon instead of em dash in archived pages list (em dash was
  confusing Vale's parser when adjacent to Hugo shortcode syntax)
- Lowercase 'Upstream' used as adjective in further reading links
@mcharriere mcharriere requested a review from a team May 12, 2026 21:07
Copy link
Copy Markdown
Contributor

@pipo02mix pipo02mix left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please bump last_review_date in all modified files

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.

3 participants