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

[doc] Add release notes v1.33.0 #21885

Merged

Conversation

SeanCurtis-TRI
Copy link
Contributor

@SeanCurtis-TRI SeanCurtis-TRI commented Sep 9, 2024

This change is Reviewable

@SeanCurtis-TRI SeanCurtis-TRI added the release notes: none This pull request should not be mentioned in the release notes label Sep 9, 2024
Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

a discussion (no related file):
Still need to:

  • Remove extraneous TBD
  • Update dates at the end of the week.


doc/_release-notes/v1.33.0.md line 53 at r1 (raw file):

<!-- <relnotes for geometry,multibody go here> -->

* [feature] TBD Replace BodyIndex with LinkIndex alias ([#21811][_#21811])

@sherm1 I commented on the PR, but this is where it's relevant.

Copy link
Member

@sherm1 sherm1 left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 53 at r1 (raw file):

Previously, SeanCurtis-TRI (Sean Curtis) wrote…

@sherm1 I commented on the PR, but this is where it's relevant.

You're right that this change is entirely internal and shouldn't be mentioned here. My bad!

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 1 unresolved discussion, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits)


doc/_release-notes/v1.33.0.md line 53 at r1 (raw file):

Previously, sherm1 (Michael Sherman) wrote…

You're right that this change is entirely internal and shouldn't be mentioned here. My bad!

Thanks

Copy link
Contributor

@cohnt cohnt left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 124 at r3 (raw file):

* `pydrake.multibody.MultibodyPlant.SetDefaultFreeBodyPose` with parameter X_WB ([#21808][_#21808])
* `pydrake.multibody.MultibodyPlant.SetFreeBodySpatialVelocity` with parameter V_WB ([#21808][_#21808])

#21807 deprecates CalcPairwiseIntersections and introduces a replacement ComputePairwiseIntersections with a different return signature. Not sure what message makes the most sense (and whether you also want to include it in "New features", or just in "Newly-deprecated APIs").

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits)


doc/_release-notes/v1.33.0.md line 124 at r3 (raw file):

Previously, cohnt (Thomas Cohn) wrote…

#21807 deprecates CalcPairwiseIntersections and introduces a replacement ComputePairwiseIntersections with a different return signature. Not sure what message makes the most sense (and whether you also want to include it in "New features", or just in "Newly-deprecated APIs").

Thanks for calling this out. I'll do a refresh on this branch tomorrow to pick up changes since Monday morning and that should get included. I'll leave this topic open to make sure I don't miss it.

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits)


doc/_release-notes/v1.33.0.md line 124 at r3 (raw file):

Previously, SeanCurtis-TRI (Sean Curtis) wrote…

Thanks for calling this out. I'll do a refresh on this branch tomorrow to pick up changes since Monday morning and that should get included. I'll leave this topic open to make sure I don't miss it.

Alrighty. Taken care of officially.

Copy link
Contributor

@cohnt cohnt left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 124 at r3 (raw file):

Previously, SeanCurtis-TRI (Sean Curtis) wrote…

Alrighty. Taken care of officially.

Does drake::geometry::CalcPairwiseIntersections encompass the python bindings? (The corresponding bindings have also been deprecated.)

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewed 1 of 2 files at r1.
Reviewable status: 5 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 14 at r5 (raw file):

* Changed return values for GraphOfConvexSets SolveShortestPath and SolveConvexRestriction functions to resolve inconsistencies ([#21833][_#21833])
* Changed return value of GraphOfConvexSets::GetSolution*() to return std::nullopt rather than NaN ([#21843][_#21843])

Neither 21833 nor 21843 are a breaking change, since the GraphOfConvexSets class is documented as @experimental.

It might be an important change that merits a stronger-than-usual highlight somewhere in the notes, but we should do ourselves the disservice of claiming that we broke the rules in cases where we didn't.


doc/_release-notes/v1.33.0.md line 70 at r5 (raw file):

New features

* Add PathEnergyCost to GCSTrajectoryOptimization ([#21810][_#21810])

nit The class name is camel GcsTrajectoryOptimization not scream GCSTrajectoryOptimization. (Ditto throughout.)


doc/_release-notes/v1.33.0.md line 109 at r5 (raw file):

<!-- <relnotes for cmake,doc,setup,third_party,tools go here> -->

* [fix] TBD [third_party,workspace] [workspace] Upgrade bazelisk to latest release v1.21.0 ([#21888][_#21888])

nit I like how 21888 is listed beside 21884 down below. That means we can delete this line.

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewable status: 5 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 14 at r5 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

Neither 21833 nor 21843 are a breaking change, since the GraphOfConvexSets class is documented as @experimental.

It might be an important change that merits a stronger-than-usual highlight somewhere in the notes, but we should do ourselves the disservice of claiming that we broke the rules in cases where we didn't.

*shouldn't

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewable status: 6 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 15 at r5 (raw file):

* Changed return values for GraphOfConvexSets SolveShortestPath and SolveConvexRestriction functions to resolve inconsistencies ([#21833][_#21833])
* Changed return value of GraphOfConvexSets::GetSolution*() to return std::nullopt rather than NaN ([#21843][_#21843])
* drake::multibody::FrameBase class removed ([#21853][_#21853])

Blocking the release until #21891 is merged.

@SeanCurtis-TRI SeanCurtis-TRI marked this pull request as ready for review September 11, 2024 15:06
Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 4 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits)


doc/_release-notes/v1.33.0.md line 124 at r3 (raw file):

Previously, cohnt (Thomas Cohn) wrote…

Does drake::geometry::CalcPairwiseIntersections encompass the python bindings? (The corresponding bindings have also been deprecated.)

A fine point. Added.


doc/_release-notes/v1.33.0.md line 14 at r5 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

*shouldn't

@RussTedrake I've moved it to announcements. Should we simply pull them?


doc/_release-notes/v1.33.0.md line 70 at r5 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

nit The class name is camel GcsTrajectoryOptimization not scream GCSTrajectoryOptimization. (Ditto throughout.)

I only found the one.


doc/_release-notes/v1.33.0.md line 109 at r5 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

nit I like how 21888 is listed beside 21884 down below. That means we can delete this line.

Oops. That was simply an oversight.

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewed 1 of 1 files at r6, all commit messages.
Reviewable status: 3 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 70 at r5 (raw file):

Previously, SeanCurtis-TRI (Sean Curtis) wrote…

I only found the one.

Great. (I hadn't looked.)

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 15 at r5 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

Blocking the release until #21891 is merged.

This has merged to master now, to feel free to close this thread once you merge that in here -- at which point, this bullet should relocate from "breaking changes" down into "newly deprecated".

Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

Reviewed 1 of 1 files at r7, all commit messages.
Reviewable status: 4 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)


doc/_release-notes/v1.33.0.md line 67 at r7 (raw file):

* Update APIs on MultibodyPlant for working with free bodies to more clearly reflect current implementation ([#21808][_#21808])
* Fix Drake Model Directive default_free_body_pose vs offset frames ([#21765][_#21765])
* When .mtl files are missing, render colors instead ([#21889][_#21889])

nit This line should probably mention meshcat, for clarity?


doc/_release-notes/v1.33.0.md line 127 at r7 (raw file):

* Upgrade buildifier to latest release v7.3.1 ([#21887][_#21887])
* Upgrade clp_internal to latest release releases/1.17.10 ([#21887][_#21887])
* Upgrade coinutils_internal to latest release releases/2.11.12 ([#21887][_#21887])

nit Please strip chaff off of the version numbers. (Ideally we would teach the automation tool to handle this for us, but we haven't done that yet.)

Suggestion:

* Upgrade clp_internal to latest release 1.17.10 ([#21887][_#21887])
* Upgrade coinutils_internal to latest release 2.11.12 ([#21887][_#21887])

doc/_release-notes/v1.33.0.md line 132 at r7 (raw file):

* Upgrade dm_control_internal to latest release 1.0.22 ([#21887][_#21887])
* Upgrade googlebenchmark to latest release v1.9.0 ([#21887][_#21887])
* Upgrade gz_math_internal to latest release gz-math7_7.5.1 ([#21887][_#21887])

nit Please strip chaff off of the version number.

Suggestion:

7.5.1

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Last call. I've updated for this morning's clean CI and will be cutting a release today.

Reviewable status: needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

@jwnimmer-tri jwnimmer-tri added the status: single reviewer ok https://drake.mit.edu/reviewable.html label Sep 13, 2024
@jwnimmer-tri jwnimmer-tri self-assigned this Sep 13, 2024
Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

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

:lgtm: +(status: single reviewer ok) +@jwnimmer-tri both.

Reviewed 1 of 1 files at r9, all commit messages.
Reviewable status: 2 unresolved discussions, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

a discussion (no related file):
nit Reminder that this PR also should change doc/_pages/from_binary.md as you proceed through the playbook, before merging.



doc/_release-notes/v1.33.0.md line 108 at r9 (raw file):

* Add Python bindings for drake::geometry::optimization::ConvexHull ([#21849][_#21849])
* Bind Joint.kTypeName constants ([#21896][_#21896])

BTW Not a big deal, but if you like these two bullets could use a more uniform phrasing. "Bind (thing)" is generally my favorite spelling.

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 2 unresolved discussions, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits)


doc/_release-notes/v1.33.0.md line 108 at r9 (raw file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

BTW Not a big deal, but if you like these two bullets could use a more uniform phrasing. "Bind (thing)" is generally my favorite spelling.

I had the same thought but ended up on "meh". I'll get around to it once I'm done my current pass on the MeshSource stuff.

Copy link
Contributor

@rpoyner-tri rpoyner-tri left a comment

Choose a reason for hiding this comment

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

Reviewed 1 of 2 files at r1, 1 of 1 files at r9, all commit messages.
Reviewable status: 2 unresolved discussions, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 1 unresolved discussion, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

a discussion (no related file):

Previously, jwnimmer-tri (Jeremy Nimmer) wrote…

nit Reminder that this PR also should change doc/_pages/from_binary.md as you proceed through the playbook, before merging.

Updated


a discussion (no related file):
Blocking. Waiting on successful wheel builds.


Copy link
Contributor

@rpoyner-tri rpoyner-tri left a comment

Choose a reason for hiding this comment

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

Reviewed 3 of 3 files at r10, all commit messages.
Reviewable status: 1 unresolved discussion, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

Reviewable status: 1 unresolved discussion, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits) (waiting on @SeanCurtis-TRI)

a discussion (no related file):

Previously, SeanCurtis-TRI (Sean Curtis) wrote…

Blocking. Waiting on successful wheel builds.

Wheels succsesfully built.


@SeanCurtis-TRI SeanCurtis-TRI added the status: squashing now https://drake.mit.edu/reviewable.html#curated-commits label Sep 13, 2024
Copy link
Contributor Author

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

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

+(status: squashing now)

Reviewable status: :shipit: complete! all discussions resolved, LGTM from assignee jwnimmer-tri(platform)

@SeanCurtis-TRI SeanCurtis-TRI merged commit 345c1a0 into RobotLocomotion:master Sep 13, 2024
9 checks passed
@SeanCurtis-TRI SeanCurtis-TRI deleted the release_notes-v1.33.0 branch September 13, 2024 20:05
RussTedrake pushed a commit to RussTedrake/drake that referenced this pull request Dec 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release notes: none This pull request should not be mentioned in the release notes status: single reviewer ok https://drake.mit.edu/reviewable.html status: squashing now https://drake.mit.edu/reviewable.html#curated-commits
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants