- see #28969
Comment From: sbrannen
Thanks for the PR.
Please note, however, that #28969 was assigned to @philwebb before you submitted the PR since the team had already decided that he would update the Javadoc.
In the future, please do not submit a PR for an assigned issue without first asking if an external contribution is desired.
Also, the examples in this PR are not exactly what we had in mind. Rather, we plan to add examples that are more concrete and enlightening than the technical ones proposed here.
In light of that, we might close this PR, but I will assign it to @philwebb and leave it up to him.
Comment From: philwebb
Thanks very much for the PR @Nheyll, the second examples in your Javadoc was quite close to what I had in mind. In the end I wanted a bit more text around why you'd want to use the methods so I've gone with this update.
Sorry your PR didn't get merged this time, but thanks anyway for your efforts.