Opened 2 years ago

Closed 2 years ago

Last modified 2 years ago

#27963 closed Cleanup/optimization (fixed)

Docstring example in docs doesn't follow PEP 257

Reported by: Mikkel Munch Mortensen Owned by: nobody
Component: Documentation Version: 1.10
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

This is a bit of a pedantic issue with the docs.

This page says "In docstrings, follow PEP 257". Which is then immediately followed by an example that does _not_ follow the PEP 257 convention for one-line docstrings. Is that something that has been discussed a billion times or is it actually a bug?

It caused a somewhat heated discussion on our team today :)

Change History (4)

comment:1 Changed 2 years ago by Mikkel Munch Mortensen

comment:2 Changed 2 years ago by Tim Graham

Has patch: set
Summary: Example in docs doesn't follow PEP 257 in example immediately following the note about following PEP 257Docstring example in docs doesn't follow PEP 257
Triage Stage: UnreviewedAccepted
Type: UncategorizedCleanup/optimization

comment:3 Changed 2 years ago by Tim Graham <timograham@…>

Resolution: fixed
Status: newclosed

In 1e93210:

Fixed #27963 -- Removed unneeded docstring example in contributing docs.

comment:4 Changed 2 years ago by Tim Graham <timograham@…>

In 98f8e80:

[1.11.x] Fixed #27963 -- Removed unneeded docstring example in contributing docs.

Backport of 1e93210f1f622b692dd65e861f0793ac61552d28 from master

Note: See TracTickets for help on using tickets.
Back to Top