Description

terryjreedy

opened on Jan 13, 2026

Issue body actions

Improve the IDLE doc entry for the Format / Format Paragraph menu item, based on this discuss topic.

• Define 'paragraph' to better match what is dependably handled as more or less expected. In particular, specify equal indents.
• Mention that indent of result is indent of paragraph.
• And how to modify max length.
• And to not rewrap code.

I consider the last point to be implicit in the current entry and more obviously so in the revision already prepared. I included it in the initial version but will consider removing it after more discussion.

Linked PRs

• gh-143774 - Improve IDLE Format Paragraph doc #143775
• [3.14] gh-143774 - Improve IDLE Format Paragraph doc (GH-143775) #144062
• [3.13] gh-143774 - Improve IDLE Format Paragraph doc (GH-143775) #144063

Activity

1. terryjreedy

   self-assigned this

   on Jan 13, 2026
2. terryjreedy

   added this to IDLE Issueson Jan 13, 2026
3. terryjreedy

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   topic-IDLE

   on Jan 13, 2026
4. github-project-automation

   added this to docs issueson Jan 13, 2026
5. github-project-automation

   moved this to Todo in docs issueson Jan 13, 2026
6. terryjreedy

   added a commit that references this issue on Jan 13, 2026

   pythongh-143774 - Improve IDLE Format Paragraph doc

   a9bfbf8
7. Alisa211 commented on Jan 14, 2026

   

   Alisa211

   on Jan 14, 2026

   More actions

   Hi, I’d like to work on this issue if it’s still available.
   I’m starting with documentation contributions while preparing for GSoC 2026.
   Please let me know if this approach is okay.
8. Alisa211 commented on Jan 14, 2026

   

   Alisa211

   on Jan 14, 2026

   More actions

   Thanks for the context! I see there is already a linked PR and ongoing discussion.

   If there’s any remaining documentation cleanup, clarification, or follow-up work needed, I’d be happy to help with that. Otherwise, I’m also happy to look for another docs issue to start with.
9. adorilson commented on Jan 15, 2026

   

   adorilson

   on Jan 15, 2026

   Contributor

   More actions

   You are welcome, @Alisa211

   Otherwise, I’m also happy to look for another docs issue to start with.

   Maybe you could help with #106318. It is easy, and there are several related PRs to serve as guidelines.
10. terryjreedy commented on Jan 15, 2026

    

    terryjreedy

    on Jan 15, 2026

    MemberAuthor

    More actions

    IDLE doc issues can be found in the IDLE project Documentation section, currently # 303. Apparently none have PRs, but most are not easy. If you want to help on one, say so on the issue. I am planning to pick some more to work on. In at least some cases, the possible new text should be discussed first on the issue.

    There are also some draft issues; I don't know who else can touch them, or turn into a proper issue.

    A couple of issues might be done already -- I plan to review.
11. terryjreedy

    added

    type-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error

    on Jan 15, 2026
12. terryjreedy

    added a commit that references this issue on Jan 20, 2026

    gh-143774 - Improve IDLE Format Paragraph doc (#143775)

    fa3abf5
13. miss-islington

    added 2 commits that reference this issue on Jan 20, 2026

    pythongh-143774 - Improve IDLE Format Paragraph doc (pythonGH-143775)

    07d5868

    pythongh-143774 - Improve IDLE Format Paragraph doc (pythonGH-143775)

    88510a4
14. terryjreedy

    added 2 commits that reference this issue on Jan 20, 2026

    [3.13] gh-143774 - Improve IDLE Format Paragraph doc (GH-143775) (#14…

    746d2f9

    [3.14] gh-143774 - Improve IDLE Format Paragraph doc (GH-143775) (#14…

    f318126
15. terryjreedy

    closed this as completedon Jan 20, 2026
16. github-project-automation

    moved this to Done in IDLE Issueson Jan 20, 2026
17. thunder-coding

    added a commit that references this issue on Feb 15, 2026

    pythongh-143774 - Improve IDLE Format Paragraph doc (python#143775)

    49584cd

Issue actions