Rollup merge of rust-lang#100255 - thedanvail:issue-98861-fix, r=josh…

…triplett

Adding more verbose documentation for `std::fmt::Write`

Attempts to address rust-lang#98861

library/core/src/fmt/mod.rs

@@ -119,6 +119,10 @@ pub trait Write {
  ///
  /// This function will return an instance of [`Error`] on error.
  ///
+ /// The purpose of std::fmt::Error is to abort the formatting operation when the underlying
+ /// destination encounters some error preventing it from accepting more text; it should
+ /// generally be propagated rather than handled, at least when implementing formatting traits.
+ ///
  /// # Examples
  ///
  /// ```