From 8edc0696b9357f60518f54fd4de9a737e3640431 Mon Sep 17 00:00:00 2001
From: Josh Triplett <josh@joshtriplett.org>
Date: Sun, 24 May 2026 07:34:39 +0200
Subject: [PATCH] Rewrite documentation that said to implement `Into`

---
 library/core/src/convert/mod.rs | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/library/core/src/convert/mod.rs b/library/core/src/convert/mod.rs
index 85d42b57dc06e..46b0e8c6b67cd 100644
--- a/library/core/src/convert/mod.rs
+++ b/library/core/src/convert/mod.rs
@@ -5,11 +5,10 @@
 //!
 //! - Implement the [`AsRef`] trait for cheap reference-to-reference conversions
 //! - Implement the [`AsMut`] trait for cheap mutable-to-mutable conversions
-//! - Implement the [`From`] trait for consuming value-to-value conversions
-//! - Implement the [`Into`] trait for consuming value-to-value conversions to types
-//!   outside the current crate
-//! - The [`TryFrom`] and [`TryInto`] traits behave like [`From`] and [`Into`],
-//!   but should be implemented when the conversion can fail.
+//! - Implement the [`From`] trait for consuming value-to-value conversions that cannot fail. This
+//!   automatically provides an implementation of [`Into`]
+//! - Implement the [`TryFrom`] trait for consuming value-to-value conversions that can fail. This
+//!   automatically provides an implementation of [`TryInto`]
 //!
 //! The traits in this module are often used as trait bounds for generic functions such that
 //! arguments of multiple types are supported. See the documentation of each trait for examples.
@@ -18,9 +17,9 @@
 //! [`TryFrom<T>`][`TryFrom`] rather than [`Into<U>`][`Into`] or [`TryInto<U>`][`TryInto`],
 //! as [`From`] and [`TryFrom`] provide greater flexibility and offer
 //! equivalent [`Into`] or [`TryInto`] implementations for free, thanks to a
-//! blanket implementation in the standard library. When targeting a version prior to Rust 1.41, it
-//! may be necessary to implement [`Into`] or [`TryInto`] directly when converting to a type
-//! outside the current crate.
+//! blanket implementation in the standard library. In versions of Rust prior to Rust 1.41,
+//! it was sometimes necessary to implement [`Into`] or [`TryInto`] directly when converting to a
+//! type outside the current crate.
 //!
 //! # Generic Implementations
 //!