Suggested Improvements for Grammar and Clarity in Subsections of Chapter 10.2 and Chapter 19.2

[hegotit]

trafficstars

• I have searched open and closed issues and pull requests for duplicates, using these search terms:

  • 10.2
  • iterating over

• I have checked the latest main branch to see if this has already been fixed, in this file:

  • src/ch10-02-traits.md
  • src/ch19-03-advanced-traits.md

Note: Although the file name is ch19-03-advanced-traits.md, it corresponds to Chapter 19.2 in the actual content.

URL to the section(s) of the book with this problem:

• Chapter 10.2
  • Subsection: Returning Types That Implement Traits
• Chapter 19.2
  • Subsection: Specifying Placeholder Types in Trait Definitions with Associated Types

Description of the problem:

1. Chapter 10.2

   • Subsection: Returning Types That Implement Traits (3rd paragraph within this subsection)
   • Current Text:

     "The ability to specify a return type only by the trait it implements is especially useful in the context of closures and iterators, which we cover in Chapter 13."

   • Suggested Improvement: The use of future tense ("will cover") might be more appropriate here, as is done in other parts of the book.
   • Proposed Fix:

     "The ability to specify a return type only by the trait it implements is especially useful in the context of closures and iterators, which we will cover in Chapter 13."

2. Chapter 19.2

   • Subsection: Specifying Placeholder Types in Trait Definitions with Associated Types (3rd paragraph within this subsection)
   • Current Text:

     "The associated type is named Item and stands in for the type of the values the type implementing the Iterator trait is iterating over."

   • Suggested Improvement: Rephrasing the sentence to use "over which", a formal and explicit clause marker, could clarify the grammatical structure, which will be especially beneficial for non-native English speakers.
   • Proposed Fix:

     "The associated type is named Item and stands in for the type of the values over which the type implementing the Iterator trait is iterating."