🌐 AI搜索 & 代理 主页
Skip to content

Conversation

@timmywil
Copy link
Member

@timmywil timmywil commented Aug 8, 2023

Summary

Authors

  • Checking and updating authors has been migrated to a custom script in the repo

Changelog

  • changelogplease is no longer maintained
  • generate changelog in markdown for GitHub releases
  • generate changelog in HTML for blog posts

dist

  • clone dist repo, copy files, and commit/push
  • commit tag with dist files on the 3.x-stable branch; remove dist files from main branch after release
    • Intentionally committed on the branch rather than creating a detached tag, which triggers warnings on GitHub. It's debatable whether we need to commit the dist files on the tag commit, but since we are, they need to be removed in a subsequent commit when doing it on the branch.
    • Sort of related to the subsequent commit, I lean towards not updating the version back to a -pre version. It's a practice we invented and have been doing a long time, but I'm not sure is actually necessary. It simplifies some release-it steps to not do it, which bases it's automatic version detection on the assumption that the version in package.json is the last version released. Besides, our -pre version is often wrong anyway (for instance, when the next version is going to be a minor or major instead of a patch). If jquery-git.js is a concern, it does already include the SHA in the header and I think we could remove the version there completely.

cdn

  • clone cdn repo, copy files, and commit/push
  • create versioned and unversioned copies in cdn/
    • Intentionally moved out of the dist/ folder. It never really needed to be there and it makes even less sense on the main branch with dist-module/ being a thing. The separation also simplifies some scripts.
  • generate md5 sums and archives for Google and MSFT

GH actions

  • add GitHub workflow for running releases in CI
  • releases can be triggered from GitHub; args can be added for pre releases
  • npm publish can now run with provenance

Fixes jquery/jquery-release#114

Checklist

@@ -1,3 +1,5 @@
Authors ordered by first contribution.
Copy link
Member Author

Choose a reason for hiding this comment

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

This line was accidentally removed at some point. The main branch still has it.

Alex <aleksandrosansan@gmail.com>
Timo Tijhof <krinkle@fastmail.com>
Gabriela Gutierrez <gabigutierrez@google.com>
Dimitri Papadopoulos Orfanos <3234522+DimitriPapadopoulos@users.noreply.github.com>
Copy link
Member Author

Choose a reason for hiding this comment

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

I know the number of changes looks odd, but I've confirmed that grunt authors has the same result. My guess is this has something to do with privacy rules being respected more accurately in git logs.

Copy link
Member

Choose a reason for hiding this comment

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

No, and I actually made these changes long ago on purpose... This was to certify that contributions to Sizzle matter as much to jQuery as contributions to the main jQuery repo. I changed the file so that the entries are ordered by the first contribution to any of those two repositories. I'd like to preserve that.

Cf. https://github.com/jquery/jquery/pull/4395/files#diff-b897336dda0579c40f3623b68eb6652ded79e206f4cf1af7ceb24b683fd46ff1 & https://github.com/jquery/jquery/pull/5113/files#diff-b897336dda0579c40f3623b68eb6652ded79e206f4cf1af7ceb24b683fd46ff1

Copy link
Member Author

Choose a reason for hiding this comment

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

I see. Let's incorporate that into the authors script then.

Copy link
Member

Choose a reason for hiding this comment

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

It’d be interesting to see if I made any mistakes in this ordering. 😅

Copy link
Member Author

@timmywil timmywil Aug 11, 2023

Choose a reason for hiding this comment

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

I've updated the authors script to clone the sizzle repo, combine the authors, sort by their first contribution, ensure they are unique by name, and then run cleanup so the sizzle repo doesn't stick around.

One case that I found interesting is Timo's entry. I noticed that his old email is still in the authors, whereas both emails were in there before. I think we only need the one; the email will automatically update when Timo updates the mailmap.

return changelog;
}

generate();
Copy link
Member Author

Choose a reason for hiding this comment

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

Some of this was pulled directly from changelogplease, but grouping by component with ## headers and using marked to then convert to HTML is what's new. changelog.md is also written to a file now and I've intentionally left that out of the .npmignore so it's included in releases.

*Authors*
- Checking and updating authors has been migrated
  to a custom script in the repo

*Changelog*
- changelogplease is no longer maintained
- generate changelog in markdown for GitHub releases
- generate changelog in HTML for blog posts

*dist*
- clone dist repo, copy files, and commit/push
- commit tag with dist files on the 3.x-stable branch;
  remove dist files from main branch after release

*cdn*
- clone cdn repo, copy files, and commit/push
- create versioned and unversioned copies in cdn/
- generate md5 sums and archives for Google and MSFT

*GH actions*
- add GitHub workflow for running releases in CI
- releases can be triggered from GitHub; args
  can be added for pre releases
- npm publish can now run with provenance

Fixes jquery/jquery-release#114
@mgol
Copy link
Member

mgol commented Aug 16, 2023

@timmywil are you targeting it at 4.0 or 3.x? I may not have time to do the full review before September 4 (it may happen but no promises).

@timmywil
Copy link
Member Author

@mgol I mostly wanted to see how hard it was so I hadn't decided yet, but I think I should release 3.7.1 and we can keep churning on this.

@timmywil
Copy link
Member Author

Closing in favor of #5522

@timmywil timmywil closed this Jul 18, 2024
@timmywil timmywil deleted the release-3.x branch July 18, 2024 15:10
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Sep 24, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Development

Successfully merging this pull request may close these issues.

2 participants