Skip to content

Version support tags and warnings for docs - #1260

Merged
iethree merged 2 commits into
masterfrom
gro-760-add-eol-status-to-docs-pages-and-version-picker
Jul 30, 2026
Merged

Version support tags and warnings for docs#1260
iethree merged 2 commits into
masterfrom
gro-760-add-eol-status-to-docs-pages-and-version-picker

Conversation

@iethree

@iethree iethree commented Jul 28, 2026

Copy link
Copy Markdown
Contributor
  1. Add EoL Warning to versions of docs that are unsupported
CleanShot 2026-07-28 at 13 06 18
  1. Add version support tags to version picker
CleanShot 2026-07-28 at 14 44 22

qq: should we filter this to only supported versions?

  1. Add version support tags to /docs/all
CleanShot 2026-07-28 at 16 28 12
  1. Adds a workflow that checks version-info.json every night for changes to the version support data.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@alexyarosh I'm sure you'll want to wordsmith this a bit, but you might also want to think about the logic around when we should show which block. I like what I did here, but I'd defer to your judgment.

@iethree iethree changed the title version support tags and warnings Version support tags and warnings for docs Jul 28, 2026
@iethree iethree self-assigned this Jul 28, 2026
@iethree
iethree requested review from a team and alexyarosh July 28, 2026 22:35
Comment thread docs/docs-local.css

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

currently all the .scss is build in the marketing repo. this is a band-aid for some docs specific styling for now.

@losrebellos losrebellos left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Left 1 non-blocking comment ;)

--base master \
--head "$BRANCH_NAME" \
--title "Update version support data $DATE" \
--body "Automated nightly update of the major version support data\`.")

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Is that a typo?

...data\`.

@alexyarosh alexyarosh left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

bless you saint ryan 🙏🏼

Comment thread _includes/docs/blockquotes.html Outdated
{% assign support = site.data.version_support[page.version] %}
{% if support.status == "unsupported" %}
<blockquote class="version-unsupported-notice">
Version {{ page.version }} of Metabase is no longer <a class="text-purple text-underline" href="/version-support">supported</a>. Check out the <a class="text-purple text-underline" href="/docs/latest/">docs for the current stable version, Metabase {{site.docs_version}}.</a>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

can we also bold "no longer supported"? i'd also probably make it 86px and blinking, but that's why I'm not a designer

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

the words are. 👌🏼

Comment thread _layouts/docs.html
{% include docs-old-breadcrumbs.html %}
{% endif %}

{% assign support = site.data.version_support[page.version] %}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

unrelated to this PR, but god i really wish all the pages that use this layout would just be in cold storage... we switched in v42??? or something? anything that still used this layout should be dead (if not for the couple hundred people every month that for some reason still visit these)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

we should discuss "cold storage" some more when brad is back, we've talked a little about it, but it could mean several different things, technically

@@ -0,0 +1,77 @@
# Builds `site.data.version_support`, a lookup table of support status keyed by

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I'm just gonna say "sure, whatever" to this file 😅

@iethree
iethree merged commit 1744bfd into master Jul 30, 2026
1 check passed
@iethree
iethree deleted the gro-760-add-eol-status-to-docs-pages-and-version-picker branch July 30, 2026 22:33
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