Movatterモバイル変換
[0]
ホーム
URL:
画像なし
夜間モード
Contents
Menu
Expand
Light mode
Dark mode
Auto light/dark, in light mode
Auto light/dark, in dark mode
Skip to content
Python Developer's Guide
Python Developer's Guide
Getting started
Setup and building
Fixing “easy” issues (and beyond)
Git bootcamp and cheat sheet
Lifecycle of a pull request
Where to get help
Generative AI
Development workflow
Following Python’s development
Changing Python
Development cycle
Adding to the stdlib
Standard library extension modules
Changing Python’s C API
Changing CPython’s grammar
Porting to a new platform
Software Bill-of-Materials (SBOM)
Python Security Response Team (PSRT)
Issues and triaging
Issue tracker
Triaging an issue
GitHub labels
GitHub issues for BPO users
Triage Team
Documentation
Getting started
Helping with documentation
Style guide
reStructuredText markup
Translations
Translating
Coordinating
Helping with the Developer’s Guide
Testing and buildbots
Running and writing tests
Silence warnings from the test suite
Increase test coverage
Working with buildbots
New buildbot workers
Development tools
Argument Clinic
Tutorial
How-to guides
GDB support
Dynamic analysis with Clang
Tools for tracking compiler warnings
Core team
Responsibilities
Accepting pull requests
Experts index
Team log
Motivations and affiliations
How to join the core team
Memorialization
CPython’s internals
CPython source code
Guide to the parser
Compiler design
The bytecode interpreter
Garbage collector design
Status of Python versions
Python Contributor’s Guide (draft)
[Plan for the Contributor’s Guide]
Introduction
The CPython project
Code of Conduct
Roles
Governance
Generative AI
GitHub
Directory structure
Communication channels
Outreach
Issues and triaging
Issue tracker
Triaging an issue
GitHub labels
Reviewing
Triage Team
Documentation contributions
Getting started
Helping with documentation
Style guide
reStructuredText markup
Pull request lifecycle
Translating
Helping with the Developer’s Guide
Code contributions
Setup and building
Git tips
Pull request lifecycle
Development workflow
Following Python’s development
Development cycle
Adding to the stdlib
Standard library extension modules
Changing Python’s C API
Changing Python
Changing CPython’s grammar
Porting to a new platform
Software Bill-of-Materials (SBOM)
Python Security Response Team (PSRT)
Testing and buildbots
Running and writing tests
Silence warnings from the test suite
Increase test coverage
Working with buildbots
New buildbot workers
Development tools
Argument Clinic
Tutorial
How-to guides
GDB support
Dynamic analysis with Clang
Tools for tracking compiler warnings
Core team
Responsibilities
Accepting pull requests
Experts index
Team log
Motivations and affiliations
How to join the core team
Accessibility, design, and user success
Security and infrastructure contributions
Workflows
Install Git
Get the source code
Install Dependencies
Compile and build
Regenerating auto-created files
Install Git
Using GitHub Codespaces
Back to top
View this page
Edit this page
Documentation
¶
Getting started
Introduction
Building the documentation
Initial requirements
Create a virtual environment
Build using make / make.bat
Build using Sphinx directly
Helping with documentation
Python documentation
Helping with documentation issues
Translating
Proofreading
Style guide
Footnotes
Capitalization
Specific words
Use simple language
Diátaxis
Links
Affirmative tone
Author attribution
Pronunciation of dunder names
Economy of expression
Security considerations (and other concerns)
Code examples
Code equivalents
Audience
Function signatures
reStructuredText markup
Quick reference
reStructuredText primer
Use of whitespace
Paragraphs
Inline markup
Lists and quotes
Source code
Hyperlinks
External links
Internal links
Sections
Explicit markup
Directives
Footnotes
Comments
Source encoding
Gotchas
Typographic conventions
Big
O
notation
Additional markup constructs
Meta-information markup
Module-specific markup
Information units
Showing code examples
Roles
Cross-linking markup
Paragraph-level markup
Table-of-contents markup
Index-generating markup
Grammar production displays
Substitutions
Translations
Translating
How to get help
Style guide
Translate the meaning
Gender neutrality
Roles and links
Translation quality
Terminology
Dialects
Code examples
Transifex
Resources
Translation FAQ
How do I build a docs translation?
Which version of the Python documentation should I work on?
How do I translate the Python Docs Sphinx Theme?
The coordination team for my language is inactive, what do I do?
Coordinating
Communication/help channels
Starting a new translation
Announcement
Coordination team
Translation team
Repository
Cookiecutter/bootstrapper
Translation platform
Glossary
Moving the repo to the
python
org
Adding to the language switcher
PEP 545 summary
Translating Sphinx
Coordination FAQ
Are there tools to help in managing the repo?
How should I test my translation?
How is a coordination team chosen?
I have a translation, but it’s not in Git. What should I do?
My Git hierarchy does not match yours. Can I keep it?
What hierarchy should I use in my GitHub repository?
Which version of the Python documentation should be translated?
The entry for my translation is missing or not up to date
How are translations built?
Is there a Weblate instance we can translate on?
Helping with the Developer’s Guide
Developer’s Guide workflow
[8]
ページ先頭
©2009-2025
Movatter.jp