Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add link to changelog entries for each version #10227

Closed
coatless opened this issue Jul 4, 2024 · 5 comments
Closed

Add link to changelog entries for each version #10227

coatless opened this issue Jul 4, 2024 · 5 comments
Labels
documentation Doc improvements & quarto-web

Comments

@coatless
Copy link
Contributor

coatless commented Jul 4, 2024

What would you like to do?

Give feedback or suggest an improvement

Description

If the Quarto version is either release or pre-release, the release notes are shown under the installer table on the Download page. However, there is no link to a permanent location for the release notes. So, once a new version comes out, we need to specify the changelog.md included as part of the source of this repository for a permanent page.

The ask:

  1. Please add permanent links to the release note page
  2. Consider placing pre-release highlights as a permanent entry

Old release

The old release table only links to the top-level tag. Depending on the tag, it's either the last commit message (1 - 1.3) or the new here's the difference between a smaller version delta and a link to the full release notes (starting at 1.4)

A screenshot of the old release table

Pre-release

Immediately proceeding the installer table, there is a link to the release highlights post that describes the top-level features for the release.

Screenshot 2024-07-04 at 9 50 51 AM Screenshot 2024-07-04 at 9 50 40 AM
@coatless coatless added the documentation Doc improvements & quarto-web label Jul 4, 2024
@mcanouil
Copy link
Collaborator

mcanouil commented Jul 8, 2024

FYI:
If you go to the "older releases" tab, you get the releases links.
Starting in 1.4, the changelog.md link was added in the release description.
For all releases, the change log is part of the assets.

@mcanouil
Copy link
Collaborator

mcanouil commented Jul 8, 2024

Consider placing pre-release highlights as a permanent entry

I am not sure what you mean exactly here.
Note that now, pre-release specific documentation updates are published in https://prerelease.quarto.org/

@mcanouil
Copy link
Collaborator

mcanouil commented Jul 8, 2024

Would adding the changelog.md links to the release table work?

@cwickham
Copy link
Collaborator

cwickham commented Jul 8, 2024

Consider placing pre-release highlights as a permanent entry

As @mcanouil said, current pre-release highlights now live on https://prerelease.quarto.org (e.g. https://prerelease.quarto.org/docs/prerelease/1.6/ ). Once released, these pages move to quarto.org (e.g. for 1.5, https://quarto.org/docs/prerelease/1.5/).

Please add permanent links to the release note page

We have an open issue for this #5396.

@cwickham
Copy link
Collaborator

We now have links to the release notes in the Older Releases table at https://quarto.org/docs/download/

In general, you'll find the release notes at https://quarto.org/docs/download/changelog/1.x/. The current (https://quarto.org/docs/download/changelog/1.5/) and prerelease (https://quarto.org/docs/download/changelog/1.6/) versions are just aliases to the download pages - this means they are automatically up to date with the current patch version. They'll transition to frozen pages on release.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Doc improvements & quarto-web
Projects
None yet
Development

No branches or pull requests

3 participants