☂️ [3.2] Evaluate changelog

[MaryaBelanger]

This is an evaluation issue

Evaluating the possible need for doc updates due to 3.2 changelog entries.

Summary

Listing out the changes in one ticket and will link to others if necessary (not anticipating much).
Details on each can be found in the changelog

Evaluation

• Private final field promotion:
  • [3.2] Private field promotion docs #4254
• Split point for refutable patterns
  • Fixing a bug/failure, failure wasn't documented, so now it just works how it "should". No change.
• Added broadcast parameter to Stream.empty constructor
  • No mention of broadcast streams or empty streams anywhere in the docs, so nowhere to add that you can change the default now.
• Changed return types of utf8.encode() and Utf8Codec.encode()
  • [3.2] Update utf8encoder return type in library tour #5115
• Deprecated the Service.getIsolateID method.
  • Not mentioned in docs.
• Added getIsolateId method to Service.
  • Not sure how/where this would be used, but since there's no mention of the previous deprecated method, I assume there's no need to mention this one anywhere either
• Added getObjectId method to Service.
  • Searched for any discussion about object IDs, didn't find anything. Not sure where this might be useful to use.
• dart:ffi:
  • found incomplete sentence in diagnostic messages:
    Incomplete sentence argument_must_be_a_constant sdk#54036
  • [3.2] Mention NativeCallable in the ObjC multithreading limitations #5336
• HttpClientResponse.headers and HttpRequest.headers return headers and fold points
  • Nothing about fold points or trailing whitespaces.
• Isolate.packageConfigSync and Isolate.resolvePackageUriSync
  • Nothing.
• JSInterop (skip)
• DDC
• dart2js
• dart create command has a new cli template
  • [3.2] Document new dart create CLI template #5249
• dart format
  • Not sure if mentioning --enable-experiment for language experiments is useful or not.
• Lints:
  • annotate_redeclares
  • use_build_context_synchronously
• Pub:
  • dart pub upgrade --tighten
    • [3.2] pub upgrade --tighten #5342
  • dart pub get/add/upgrade now shows changes between direct, dev and transitive dependency
    • None of their docs mention that they "show" anything (assuming when it's run from the command line), so there's nothing to update and probably don't need to add it now...?
  • dart pub upgrade no longer shows unchanged dependencies
    • Thought this was already the case?