Skip to content

Clarify that the Latest Releases page isn't a complete release list - #704

Open
harshasiddartha wants to merge 1 commit into
drizzle-team:mainfrom
harshasiddartha:docs-latest-releases-github-link
Open

Clarify that the Latest Releases page isn't a complete release list#704
harshasiddartha wants to merge 1 commit into
drizzle-team:mainfrom
harshasiddartha:docs-latest-releases-github-link

Conversation

@harshasiddartha

Copy link
Copy Markdown

Addresses drizzle-team/drizzle-orm#6101.

The /docs/latest-releases page renders every entry under src/content/docs/latest-releases/, and the two newest are drizzle-orm-v1beta2 (2025-02-12) and drizzle-orm-v0.32.2 / drizzle-kit-v0.23.2 (2024-08-05). Since nothing has been added since, the page reads as if the last release was over a year ago, while the actual latest release on GitHub is much more recent. As the reporter put it, it makes the project look abandoned.

This adds one line under the heading explaining that the page only covers releases with written-up notes, and linking to the GitHub releases for the full list:

This page only covers releases we've written up in detail, so it's not a complete or up to date list. For every release, see the releases on GitHub.

The alternative the issue also mentions is backfilling the page with every release since 0.32.2, or dropping it entirely and redirecting to GitHub. Both are calls for the team to make, so I went with the smallest change that stops the page from misleading people. Happy to switch to either if you'd prefer.

Styling follows the existing conventions in the component (scoped styles, html.dark override, mobile size in the existing media query), and rel="nofollow noreferrer" for the external link to match the rest of the repo.

Verification: pnpm install, npx astro check (0 errors, 0 warnings, 11 pre-existing hints), pnpm test (29 passed), and checked the rendered page on astro dev.

The page only lists releases that have written-up notes, and the newest
of those is from February 2025, which makes the project look inactive.
Add a short line under the heading pointing to the GitHub releases for
the full, current list.
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.

1 participant