Skip to content

Conversation

MikeMcC399
Copy link
Contributor

Situation

Managing the Release Changelog contains guidelines in the form of linked examples for formatting versions. These have not been consistently followed.

The example for dependency updates is cited as https://docs.cypress.io/app/references/changelog#7-2-0

image

Some semver style versions (X.Y.Z) in the Changelog are written in plain text, although they are mostly enclosed in Markdown code backticks.

Regressions are inconsistently handled and do not always follow the guidelines in Managing the Release Changelog. Harmonize formatting for existing regression links:

If a changelog item is a regression, the description should start with Fixed a regression in 9.1.0 with a link to the release that introduced it.

Change

Change all listed semver style version numbers in the Changelog to enclose them in Markdown code backticks, except in headers.

Apply this also to version ranges as used by npm/node-semver.

Add missing links when referring to regressions and harmonize existing links.

Related

Copy link

netlify bot commented Aug 11, 2025

👷 Deploy request for cypress-docs pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit b9e45ed

@cypress-app-bot
Copy link
Collaborator

@MikeMcC399 MikeMcC399 marked this pull request as ready for review August 11, 2025 14:01
Copy link

vercel bot commented Aug 11, 2025

@jennifer-shehane is attempting to deploy a commit to the Cypress Team on Vercel.

A member of the Team first needs to authorize it.

Copy link

vercel bot commented Aug 11, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
cypress-documentation ❌ Failed (Inspect) Aug 11, 2025 3:28pm

@jennifer-shehane
Copy link
Member

Vercel is broken. We're looking into it.

@MikeMcC399

This comment was marked as resolved.

@jennifer-shehane
Copy link
Member

@MikeMcC399 Thanks, some minor confusion on our side as they were both configured at one point.

@MikeMcC399

This comment was marked as resolved.

@jennifer-shehane jennifer-shehane merged commit a3c0cc9 into cypress-io:main Aug 15, 2025
5 checks passed
@MikeMcC399 MikeMcC399 deleted the changelog-version-numbers branch August 15, 2025 15:27
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