python / python/devguide

Add information about frozen stdlib modules.

Open
#756 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

topic-stdlib type-feature
Dominant language
Python
Stars
2.1k
Forks
1k
Avg merge
2d 12h
Merged PRs (30d)
12

Description

With the more stdlib modules getting frozen recently, it would be useful to have a section (or page) somewhere about:

  • what are frozen modules?
  • the different kinds of frozen modules (bootstrap vs. stdlib vs. testing)
  • how to identify or modify which stdlib modules are frozen
  • why some modules are frozen and some aren't
  • how to deal with frozen modules in tests
  • any other helpful info

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file, test, or documentation entry point is specified. Start by reviewing the devguide's existing documentation structure and material about frozen modules, then determine where this topic fits. Done means a page or section explains the listed frozen-module types, identification and modification, freezing rationale, and testing guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.