Documentation

The are a couple of paragraphs about error-checking behaviour forstr.encode andstr.decode that appears in a few versions of Python and could potentially be improved in future versions.

As found in thePython 3.9.14 documentation forstd.encode:

By default, theerrors argument is not checked for best performances, but only used at the first encoding error. Enable thePython Development Mode, or use a debug build to checkerrors.

The paragraph before that is fairly dense - there could be an opportunity to improve both of them.

Linked PRs

• gh-99991: improve docs on str.encode and bytes.decode #100198
• [3.11] gh-99991: improve docs on str.encode and bytes.decode (GH-100198) #100382
• [3.10] gh-99991: improve docs on str.encode and bytes.decode (GH-100198) #100383