Author aeros
Recipients aeros, docs@python
Date 2019-07-18.07:42:28
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1563435749.25.0.657684993159.issue37618@roundup.psfhosted.org>
In-reply-to
Content
In the docs for the module stdtypes, the code example for several commonly used functions are in the bytearray section instead of the str section, where new users are far more likely to look. The new users are much more likely to benefit from seeing examples of these functions. A few examples of this include: islower(), isupper(), and istitle(). Since the functionality is very similar for functions such as str.islower() and bytearray.islower(), it doesn't seem necessary to include separate examples for each. With that in mind, here's a couple of potential solutions:

1) Move the location of the code examples to the str equivalent. This would require only removing the 'b' notation proceeding the strings. A link to the str equivalent could be potentially provided.

2) Provide a reference link to equivalent bytearray function in the str function's summary. This would be a bit easier since the code examples would not have to me modified or moved. However, for reasons stated above, it seems to make a bit more sense to have the examples be in the str functions rather than in the bytearray functions.

I can start working on a PR to address this, but I'll wait on some feedback first.
History
Date User Action Args
2019-07-18 07:42:29aerossetrecipients: + aeros, docs@python
2019-07-18 07:42:29aerossetmessageid: <1563435749.25.0.657684993159.issue37618@roundup.psfhosted.org>
2019-07-18 07:42:29aeroslinkissue37618 messages
2019-07-18 07:42:28aeroscreate