Skip to content

Prepare 0.15.0#1091

Open
phimuemue wants to merge 3 commits intorust-itertools:masterfrom
phimuemue:0.15.0
Open

Prepare 0.15.0#1091
phimuemue wants to merge 3 commits intorust-itertools:masterfrom
phimuemue:0.15.0

Conversation

@phimuemue
Copy link
Copy Markdown
Member

As agreed upon in #1085 (comment).

I adapted things from a015a68 (the 0.14.0 one).

I concur, it's a bit of work to create the CHANGELOG.

@codecov
Copy link
Copy Markdown

codecov bot commented Mar 31, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.83%. Comparing base (6814180) to head (1f5bf60).
⚠️ Report is 185 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1091      +/-   ##
==========================================
- Coverage   94.38%   93.83%   -0.56%     
==========================================
  Files          48       51       +3     
  Lines        6665     6468     -197     
==========================================
- Hits         6291     6069     -222     
- Misses        374      399      +25     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Copy Markdown
Member

@jswrenn jswrenn left a comment

Choose a reason for hiding this comment

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

Per:

git log $(git describe --abbrev=0).. --reverse --oneline \
  | cut -d' ' -f1 \
  | xargs -I {} gh pr list --search {} --state merged --json number \
  | jq '.[] | .number' \
  | sort -nu

We've merged 26 PRs since v0.14, of which 14 are currently mentioned in the changelog:

We don't need to mention all of these (e.g., typo fixes and minor internal changes unlikely to cause breakage), and there's a few items currently in the changelog that I think could be elided, but a few unmentioned PRs stand out to me as warranting mention:

CHANGELOG.md Outdated
- Improve documentation for `multizip` (#1053)
- Implement `PeekingNext` for more types (#1073)
- Improve documentation
- Fix `PadUsing::next_back` (#1065)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- Fix `PadUsing::next_back` (#1065)
- Fix `PadUsing::next_back` (#1082)

CHANGELOG.md Outdated

### Notable Internal Changes
- Make `into_group_map` code more idiomatic (#1027)
- Fix clippy lints (#1076)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- Fix clippy lints (#1076)
- Fix lints (#1017, #1029, #1076)

CHANGELOG.md Outdated
Comment on lines +18 to +19
### Breaking
- Improve `Position` (#1042, #1043)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you move the 'Breaking' section before 'Changed'?

CHANGELOG.md Outdated
- Introduce `[circular_]array_windows`, deprecate `tuple_windows` (#1086)

### Breaking
- Improve `Position` (#1042, #1043)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- Improve `Position` (#1042, #1043)
- Restructure `Position` as struct instead of enum (#1042, #1043)

CHANGELOG.md Outdated
- Make `izip!` temporary friendly (#1021)
- Add `array_combinations_with_replacement` (#1033)
- Implement `Debug` for remaining public types (#1038)
- Improve `ExactlyOneError` (#1046, #1049)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- Improve `ExactlyOneError` (#1046, #1049)
- Specialize `ExactlyOneError::count` (#1046)

CHANGELOG.md Outdated
- Improve `ExactlyOneError` (#1046, #1049)
- Improve documentation for `multizip` (#1053)
- Implement `PeekingNext` for more types (#1073)
- Improve documentation
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Generally speaking, I don't think we should bother including documentation improvements in the changelog, unless the change is semantic, e.g., guaranteeing that a function never panics. In those cases, the bullet point should be quite specific about the new guarantee provided.

The role of the changelog is mostly for answering the question "my code broke when I updated, what might be the culprit".

@phimuemue
Copy link
Copy Markdown
Member Author

phimuemue commented Apr 7, 2026

@jswrenn I hope I got all of them.

Nice command line btw - maybe we should add it to the repo for next time?

Generally speaking, I don't think we should bother including documentation improvements in the changelog, unless the change is semantic, e.g., guaranteeing that a function never panics. In those cases, the bullet point should be quite specific about the new guarantee provided.

The role of the changelog is mostly for answering the question "my code broke when I updated, what might be the culprit".

I always leaned towards including also minor PRs (to give the authors credit), but I'm fine with restricting it.

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.

2 participants