# Documentation

**URL:** https://discuss.python.org/c/documentation/26.md?page=1

[Latest](https://discuss.python.org/latest.md) · [Categories](https://discuss.python.org/categories.md) · [Tags](https://discuss.python.org/tags.md)

**Page:** 2

---

## [Does a newline character count towards the Maximum Line Length in PEP-8?](https://discuss.python.org/t/does-a-newline-character-count-towards-the-maximum-line-length-in-pep-8/107847)

<div class="topic-metadata">

**Author:** [@petur](https://discuss.python.org/u/petur)\
**Replies:** 9\
**Last updated:** [June 24, 2026, 12:03am UTC](https://discuss.python.org/t/does-a-newline-character-count-towards-the-maximum-line-length-in-pep-8/107847 "2026-06-24T00:03:56Z")

</div>

PEP 8: Maximum Line Length specifies Limit all lines to a maximum of 79 characters. without defining what constitutes a line. This leads me to question whether a newline character counts towards the limit. I attempt…

---

## [Documenting isinstance behavior with faked \_\_class\_\_](https://discuss.python.org/t/documenting-isinstance-behavior-with-faked-class/107532)

<div class="topic-metadata">

**Author:** [@BenjyWiener](https://discuss.python.org/u/BenjyWiener)\
**Replies:** 1\
**Last updated:** [May 26, 2026, 10:30pm UTC](https://discuss.python.org/t/documenting-isinstance-behavior-with-faked-class/107532 "2026-05-26T22:30:08Z")

</div>

Background The current documentation is fairly vague about how isinstance works: Return True if the object argument is an instance of the classinfo argument, or of a (direct, indirect, or virtual) subclass thereof. If o…

---

## [Documentation community meeting: 19:00 UTC, Tuesday 2nd June, 2026](https://discuss.python.org/t/documentation-community-meeting-19-00-utc-tuesday-2nd-june-2026/107531)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [May 26, 2026, 7:54am UTC](https://discuss.python.org/t/documentation-community-meeting-19-00-utc-tuesday-2nd-june-2026/107531 "2026-05-26T07:54:40Z")

</div>

The next docs meeting will be held on Tuesday 2nd June, 2026, at 19:00 UTC on Discord. The agenda will be on HackMD. If you have any topics to discuss, please add them there so we can allocate time better. But important…

---

## [Documentation community meeting: 16:00 UTC, Tuesday 5th May, 2026](https://discuss.python.org/t/documentation-community-meeting-16-00-utc-tuesday-5th-may-2026/107138)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [April 30, 2026, 1:48pm UTC](https://discuss.python.org/t/documentation-community-meeting-16-00-utc-tuesday-5th-may-2026/107138 "2026-04-30T13:48:56Z")

</div>

The next docs meeting will be held on Tuesday 5th May, 2026, at 16:00 UTC on Discord. The agenda will be on HackMD. If you have any topics to discuss, please add them there so we can allocate time better. But important …

---

## [Where should the task lifecycle warning belong in asyncio docs?](https://discuss.python.org/t/where-should-the-task-lifecycle-warning-belong-in-asyncio-docs/107045)

<div class="topic-metadata">

**Author:** [@elis.byberi](https://discuss.python.org/u/elis.byberi)\
**Replies:** 6\
**Last updated:** [April 23, 2026, 4:31am UTC](https://discuss.python.org/t/where-should-the-task-lifecycle-warning-belong-in-asyncio-docs/107045 "2026-04-23T04:31:44Z")

</div>

Should the important note be added to loop.create\_task() as well, similar to the one in asyncio.create\_task()? Or should that note instead be moved to asyncio.Task? Important Save a reference to the result of this fun…

---

## [Starting Vietnamese Translation](https://discuss.python.org/t/starting-vietnamese-translation/107028)

<div class="topic-metadata">

**Author:** [@tamnd](https://discuss.python.org/u/tamnd)\
**Replies:** 0\
**Last updated:** [April 18, 2026, 11:11am UTC](https://discuss.python.org/t/starting-vietnamese-translation/107028 "2026-04-18T11:11:11Z")

</div>

Hello everyone, I’m starting a Vietnamese translation of the Python documentation. The goal is simple: make Python easier to learn and use for Vietnamese speakers, especially students and beginners who prefer reading in…

---

## [Possible inaccuracies in expression\_stmt syntax documentation (3.14.4)](https://discuss.python.org/t/possible-inaccuracies-in-expression-stmt-syntax-documentation-3-14-4/106950)

<div class="topic-metadata">

**Author:** [@AEErshov](https://discuss.python.org/u/AEErshov)\
**Replies:** 3\
**Last updated:** [April 15, 2026, 4:21am UTC](https://discuss.python.org/t/possible-inaccuracies-in-expression-stmt-syntax-documentation-3-14-4/106950 "2026-04-15T04:21:54Z")

</div>

I think I’ve found some issues with how expression syntax is described in the official Python documentation for version 3.14.4. According to the docs: expression\_stmt: starred\_expression And starred\_expression is defi…

---

## [A small typo on 5.1 More on Lists section](https://discuss.python.org/t/a-small-typo-on-5-1-more-on-lists-section/106150)

<div class="topic-metadata">

**Author:** [@BerkeYalci](https://discuss.python.org/u/BerkeYalci)\
**Replies:** 23\
**Last updated:** [March 26, 2026, 7:55pm UTC](https://discuss.python.org/t/a-small-typo-on-5-1-more-on-lists-section/106150 "2026-03-26T19:55:02Z")

</div>

Hello. I hope that’s the right place to report this. I just noticed a simple typo at: 5. Data Structures — Python 3.14.3 documentation list.pop(\[i\]) has to be list.pop(i).

---

## [Plans to update Python's generics docs?](https://discuss.python.org/t/plans-to-update-pythons-generics-docs/106686)

<div class="topic-metadata">

**Author:** [@jason-s](https://discuss.python.org/u/jason-s)\
**Replies:** 2\
**Last updated:** [March 25, 2026, 6:12pm UTC](https://discuss.python.org/t/plans-to-update-pythons-generics-docs/106686 "2026-03-25T18:12:46Z")

</div>

The typing documentation for generics is somewhat inconsistent in the use of new syntax: Generics — typing documentation (https://typing.python.org/en/latest/reference/generics.html) doesn’t include the new syntax clas…

---

## [Documentation community meeting: 19:00 UTC, Tuesday 7th April, 2026](https://discuss.python.org/t/documentation-community-meeting-19-00-utc-tuesday-7th-april-2026/106680)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [March 25, 2026, 2:06pm UTC](https://discuss.python.org/t/documentation-community-meeting-19-00-utc-tuesday-7th-april-2026/106680 "2026-03-25T14:06:43Z")

</div>

The next docs meeting will be held on Tuesday 7th April, 2026, at 19:00 UTC on Discord. :clock7::arrow\_left::clock8: Note: clocks will have gone forward to daylight saving time for both Europe and the US. So the UTC tim…

---

## [Tamil (ta) translation coordination](https://discuss.python.org/t/tamil-ta-translation-coordination/106662)

<div class="topic-metadata">

**Author:** [@terminaljoint](https://discuss.python.org/u/terminaljoint)\
**Replies:** 4\
**Last updated:** [March 24, 2026, 12:21pm UTC](https://discuss.python.org/t/tamil-ta-translation-coordination/106662 "2026-03-24T12:21:24Z")

</div>

:rocket: Tamil Translation for Python Docs (ta) – Contributors Needed! Hi everyone, I’ve started coordinating the Tamil (ta) translation of Python’s official documentation. This effort aims to make Python learning mor…

---

## [Monthly free-threading documentation meeting discontinued](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-discontinued/106565)

<div class="topic-metadata">

**Author:** [@lys.nikolaou](https://discuss.python.org/u/lys.nikolaou)\
**Replies:** 2\
**Last updated:** [March 17, 2026, 4:07pm UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-discontinued/106565 "2026-03-17T16:07:13Z")

</div>

Hey folks! Unfortunately, as I’m transitioning away from Quansight, we’ve made the decision to discontinue this monthly meeting. It’s been a great space for focused discussion, and I’m glad we were able to use it to mak…

---

## [Is the transport of the stdin readable or writable?](https://discuss.python.org/t/is-the-transport-of-the-stdin-readable-or-writable/34776)

<div class="topic-metadata">

**Author:** [@elis.byberi](https://discuss.python.org/u/elis.byberi)\
**Replies:** 3\
**Last updated:** [March 14, 2026, 9:15pm UTC](https://discuss.python.org/t/is-the-transport-of-the-stdin-readable-or-writable/34776 "2026-03-14T21:15:55Z")

</div>

0: readable streaming transport of the standard input (stdin), or None if the subprocess was not created with stdin=PIPE 1: writable streaming transport of the standard output (stdout), or None if the subprocess was no…

---

## [Monthly free-threading documentation meeting: Mon, Mar 9th at 16:00 UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-mar-9th-at-16-00-utc/106390)

<div class="topic-metadata">

**Author:** [@lys.nikolaou](https://discuss.python.org/u/lys.nikolaou)\
**Replies:** 0\
**Last updated:** [March 4, 2026, 6:34pm UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-mar-9th-at-16-00-utc/106390 "2026-03-04T18:34:30Z")

</div>

Hey folks! We’ll have our next free-threading documentation meeting on Monday, March 9th at 16:00 UTC. Like last time, the meeting will be held on Google Meet. In the meantime, you can also view last meeting’s notes.

---

## [Stubs and docstrings: official recommendations?](https://discuss.python.org/t/stubs-and-docstrings-official-recommendations/106281)

<div class="topic-metadata">

**Author:** [@pawamoy](https://discuss.python.org/u/pawamoy)\
**Replies:** 16\
**Last updated:** [March 4, 2026, 5:30pm UTC](https://discuss.python.org/t/stubs-and-docstrings-official-recommendations/106281 "2026-03-04T17:30:39Z")

</div>

Lets make it short. In docs-oriented static analysis tools, should stub docstrings override source docstrings? I would love to see some official recommendation about this in Writing and Maintaining Stub Files — typing d…

---

## [Probably not a PEP: mutating a sequence during iteration is fuzzy](https://discuss.python.org/t/probably-not-a-pep-mutating-a-sequence-during-iteration-is-fuzzy/106341)

<div class="topic-metadata">

**Author:** [@tim.one](https://discuss.python.org/u/tim.one)\
**Replies:** 10\
**Last updated:** [March 2, 2026, 8:33pm UTC](https://discuss.python.org/t/probably-not-a-pep-mutating-a-sequence-during-iteration-is-fuzzy/106341 "2026-03-02T20:33:26Z")

</div>

The docs no longer tell the truth about what happens when a mutable sequence changes length during iteration, and what actually happens varies now across the specific mutable sequence type,. This acts closest to what th…

---

## [Should not underline links](https://discuss.python.org/t/should-not-underline-links/106012)

<div class="topic-metadata">

**Author:** [@Wombat](https://discuss.python.org/u/Wombat)\
**Replies:** 30\
**Last updated:** [March 2, 2026, 6:26pm UTC](https://discuss.python.org/t/should-not-underline-links/106012 "2026-03-02T18:26:04Z")

</div>

Documentation readability has regressed because the CSS styling for links has changed. The old way was readable and beautiful: datetime — Basic date and time types — Python 3.9.24 documentation The new way is cluttered…

---

## [Documentation community meeting: 17:00 UTC, Tuesday 3rd March, 2026](https://discuss.python.org/t/documentation-community-meeting-17-00-utc-tuesday-3rd-march-2026/106300)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [February 27, 2026, 8:34am UTC](https://discuss.python.org/t/documentation-community-meeting-17-00-utc-tuesday-3rd-march-2026/106300 "2026-02-27T08:34:54Z")

</div>

The next docs meeting will be held on Tuesday 3rd March, 2026, at 17:00 UTC on Discord. The agenda will be on HackMD. If you have any topics to discuss, please add them there so we can allocate time better. But importan…

---

## [Documentation on \_\_slots\_\_ is confusing: is it a class or object variable?](https://discuss.python.org/t/documentation-on-slots-is-confusing-is-it-a-class-or-object-variable/106279)

<div class="topic-metadata">

**Author:** [@pjljvandelaar](https://discuss.python.org/u/pjljvandelaar)\
**Replies:** 2\
**Last updated:** [February 25, 2026, 10:58am UTC](https://discuss.python.org/t/documentation-on-slots-is-confusing-is-it-a-class-or-object-variable/106279 "2026-02-25T10:58:14Z")

</div>

On “3. Data model - object.\_slots\_ — Python 3.14.3 documentation”, I read This class variable can be assigned a string, iterable, or sequence of strings with variable names used by instances. \_slots\_ reserves space for…

---

## [Tracking removed HTML IDs](https://discuss.python.org/t/tracking-removed-html-ids/106037)

<div class="topic-metadata">

**Author:** [@encukou](https://discuss.python.org/u/encukou)\
**Replies:** 4\
**Last updated:** [February 12, 2026, 10:48pm UTC](https://discuss.python.org/t/tracking-removed-html-ids/106037 "2026-02-12T22:48:19Z")

</div>

Hello, There is a request for splitting up a docs page, and more will probably follow. I’d like to address an issue I see with such reorganization: preventing broken links. And by links, I mean HTML IDs – the part in t…

---

## [Monthly free-threading documentation meeting: Mon, Feb 9th at 16:00 UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-feb-9th-at-16-00-utc/105981)

<div class="topic-metadata">

**Author:** [@lys.nikolaou](https://discuss.python.org/u/lys.nikolaou)\
**Replies:** 1\
**Last updated:** [February 9, 2026, 1:05pm UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-feb-9th-at-16-00-utc/105981 "2026-02-09T13:05:12Z")

</div>

Hey folks! We’ll have our next free-threading documentation meeting on Monday, February 9th at 16:00 UTC. Like last time, the meeting will be held on Google Meet. In the meantime, you can also view last meeting’s notes.…

---

## [Trivial glitch in types.CodeType documentation](https://discuss.python.org/t/trivial-glitch-in-types-codetype-documentation/105990)

<div class="topic-metadata">

**Author:** [@crj](https://discuss.python.org/u/crj)\
**Replies:** 4\
**Last updated:** [February 3, 2026, 8:17pm UTC](https://discuss.python.org/t/trivial-glitch-in-types-codetype-documentation/105990 "2026-02-03T20:17:20Z")

</div>

In types — Dynamic type creation and names for built-in types — Python 3.14.3 documentation , it says: class types.CodeType(\*\*kwargs ) The (\*\*kwargs) is surely there by mistake?

---

## [Documentation community meeting: 20:00 UTC, Tuesday 3rd February, 2026](https://discuss.python.org/t/documentation-community-meeting-20-00-utc-tuesday-3rd-february-2026/105982)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [February 2, 2026, 3:51pm UTC](https://discuss.python.org/t/documentation-community-meeting-20-00-utc-tuesday-3rd-february-2026/105982 "2026-02-02T15:51:06Z")

</div>

The next docs meeting will be held tomorrow, Tuesday 3rd February, 2026, at 20:00 UTC on Discord. The agenda will be on HackMD. If you have any topics to discuss, please add them there so we can allocate time better. Bu…

---

## [Worldtimeapi.org is down](https://discuss.python.org/t/worldtimeapi-org-is-down/76815)

<div class="topic-metadata">

**Author:** [@artamonovkirill](https://discuss.python.org/u/artamonovkirill)\
**Replies:** 5\
**Last updated:** [January 21, 2026, 7:40am UTC](https://discuss.python.org/t/worldtimeapi-org-is-down/76815 "2026-01-21T07:40:04Z")

</div>

I’m getting an ERR\_EMPTY\_RESPONSE when trying to reach http://worldtimeapi.org/api/timezone/etc/UTC.txt (used in the code example @ 10. Brief Tour of the Standard Library — Python 3.13.1 documentation). Also, according…

---

## [Clarifying stdout flushing in Python when \\\\n appears inside a single print() call (C vs CPython behavior)](https://discuss.python.org/t/clarifying-stdout-flushing-in-python-when-n-appears-inside-a-single-print-call-c-vs-cpython-behavior/105778)

<div class="topic-metadata">

**Author:** [@Vemulakonda559](https://discuss.python.org/u/Vemulakonda559)\
**Replies:** 0\
**Last updated:** [January 17, 2026, 9:20am UTC](https://discuss.python.org/t/clarifying-stdout-flushing-in-python-when-n-appears-inside-a-single-print-call-c-vs-cpython-behavior/105778 "2026-01-17T09:20:34Z")

</div>

Hi everyone, I would like to discuss a small but potentially confusing difference between C stdio and Python’s stdout behavior that may benefit from clearer documentation. In C, when stdout is line-buffered (for exampl…

---

## [IDLE: Format Paragraph](https://discuss.python.org/t/idle-format-paragraph/105560)

<div class="topic-metadata">

**Author:** [@adorilson](https://discuss.python.org/u/adorilson)\
**Replies:** 3\
**Last updated:** [January 13, 2026, 6:25am UTC](https://discuss.python.org/t/idle-format-paragraph/105560 "2026-01-13T06:25:02Z")

</div>

What is the IDLE Format Paragraph’s purpose? If it is to format Python source code, there is a bug. Because it mixes two lines, a syntax error occurs when it runs. If the purpose is only to format the docstring (no exe…

---

## [Monthly free-threading documentation meeting: Mon, Jan 12th at 16:00 UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-jan-12th-at-16-00-utc/105523)

<div class="topic-metadata">

**Author:** [@lys.nikolaou](https://discuss.python.org/u/lys.nikolaou)\
**Replies:** 0\
**Last updated:** [January 5, 2026, 1:52pm UTC](https://discuss.python.org/t/monthly-free-threading-documentation-meeting-mon-jan-12th-at-16-00-utc/105523 "2026-01-05T13:52:48Z")

</div>

Hey folks and happy new year! We’ll have our next free-threading documentation meeting on Monday, January 5th at 16:00 UTC. Like last time, the meeting will be held on Google Meet. In the meantime, you can also view la…

---

## [Documentation community meeting: 17:00 UTC, Tuesday 6th January, 2026](https://discuss.python.org/t/documentation-community-meeting-17-00-utc-tuesday-6th-january-2026/105477)

<div class="topic-metadata">

**Author:** [@hugovk](https://discuss.python.org/u/hugovk)\
**Replies:** 0\
**Last updated:** [January 1, 2026, 3:48pm UTC](https://discuss.python.org/t/documentation-community-meeting-17-00-utc-tuesday-6th-january-2026/105477 "2026-01-01T15:48:59Z")

</div>

The next docs meeting will be held on Tuesday 6th January, 2026, at 17:00 UTC on Discord. The agenda will be on HackMD. If you have any topics to discuss, please add them there so we can allocate time better. But import…

---

## [Add pointer to asyncio's add\_signal\_handler in docs for signal module](https://discuss.python.org/t/add-pointer-to-asyncios-add-signal-handler-in-docs-for-signal-module/105324)

<div class="topic-metadata">

**Author:** [@7om](https://discuss.python.org/u/7om)\
**Replies:** 0\
**Last updated:** [December 16, 2025, 10:26am UTC](https://discuss.python.org/t/add-pointer-to-asyncios-add-signal-handler-in-docs-for-signal-module/105324 "2025-12-16T10:26:31Z")

</div>

Hi, How about adding a heads-up to the signal module documentation for asyncio users to use loop.add\_signal\_handler instead? It bit me, and I guess it would save a few users some head scratching. I’d be willing to come …

---

## [Is IDLE menu doc outdated?](https://discuss.python.org/t/is-idle-menu-doc-outdated/105298)

<div class="topic-metadata">

**Author:** [@adorilson](https://discuss.python.org/u/adorilson)\
**Replies:** 2\
**Last updated:** [December 13, 2025, 5:06pm UTC](https://discuss.python.org/t/is-idle-menu-doc-outdated/105298 "2025-12-13T17:06:20Z")

</div>

The IDLE doc says: Output windows, such as used for Edit =\> Find in Files, are a subtype of editor window. They currently have the same top menu but a different default title and context menu. But, Edit =\> Find in file…

[Previous page](https://discuss.python.org/c/documentation/26.md)

[Next page](https://discuss.python.org/c/documentation/26.md?page=2)
