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

Include changelog AND release notes in PR body #1285

Closed
fthomas opened this issue Feb 4, 2020 · 8 comments · Fixed by #1308
Closed

Include changelog AND release notes in PR body #1285

fthomas opened this issue Feb 4, 2020 · 8 comments · Fixed by #1308
Labels
enhancement New feature or request

Comments

@fthomas
Copy link
Member

fthomas commented Feb 4, 2020

When Scala Steward creates a PR it tries to find a URL for a changelog or the release notes and if found includes this in the PR body. Some projects still have an old changelog around but switched to GitHub release notes (doobie is one example). For these projects Scala Steward includes the URL to the outdated changelog instead to the more helpful and up-to-date release notes in the PR. I therefore think we should always include both URLs in the PR.

@fthomas fthomas added the enhancement New feature or request label Feb 6, 2020
@kiranbayram
Copy link
Contributor

I started working on this. Is the way displayed below okay?
For 1 url -> Release Notes/Changelog
For 2 urls -> Release Notes/Changelog - Release Notes/Changelog 2

@fthomas
Copy link
Member Author

fthomas commented Feb 7, 2020

It would be great if the link to the GitHub release notes would use "GitHub release notes" (or something similar) as text. I think Scala Steward should keep track of what it found when it looks for interesting URLs. Maybe instead of bare URIs we should use a sealed trait with subclasses like VersionDiff, CustomChangelog, CustomReleaseNotes, GitHubReleaseNotes that each wrap a URI.

@kiranbayram
Copy link
Contributor

Do we want to limit the max number of release related urls to 2 ?

@kiranbayram
Copy link
Contributor

which are displayed in PR body

@mzuehlke
Copy link
Member

mzuehlke commented Feb 8, 2020

Why restrict the information. As a developer, who has to decide on the implications of merging a PR, I want as many information as possible.
Currently, we are showing (if possible) a GitHub diff either a changelog or the GitHub release.
If we can in the future show information, I would like that.
The 4 types of URI @fthomas mentions above could, in my opinion, all be shown in the same PR.

@fthomas
Copy link
Member Author

fthomas commented Feb 8, 2020

I agree with @mzuehlke, let's include all URLs Scala Steward finds. We can always add a limit later if we find out that there are cases where Scala Steward includes too much.

@kiranbayram
Copy link
Contributor

Alright, i agree with that too. I'll try it that way 👍

@kiranbayram
Copy link
Contributor

This should be closed now

@fthomas fthomas linked a pull request Feb 10, 2020 that will close this issue
@fthomas fthomas closed this as completed Feb 10, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants