Skip to content

Commit cb39eca

Browse files
hugovkAA-Turnerezio-melotti
authored
Use sentence case for titles (#1162)
Co-authored-by: Adam Turner <[email protected]> Co-authored-by: Ezio Melotti <[email protected]>
1 parent 5d27e91 commit cb39eca

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+179
-179
lines changed

Diff for: core-developers/become-core-developer.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
.. _coredev:
33

44
==============================
5-
How to Become a Core Developer
5+
How to become a core developer
66
==============================
77

8-
What it Takes
8+
What it takes
99
=============
1010

1111
When you have consistently contributed patches which meet quality standards
@@ -22,7 +22,7 @@ an official offer. How core developers come to that agreement are outlined in
2222
:pep:`13`.
2323

2424

25-
Gaining Commit Privileges
25+
Gaining commit privileges
2626
=========================
2727

2828
After a candidate has demonstrated consistent contributions, commit privileges

Diff for: core-developers/committing.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
.. _committing:
22

3-
Accepting Pull Requests
3+
Accepting pull requests
44
=======================
55

66
.. highlight:: none

Diff for: core-developers/developer-log.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _developer-log:
22
.. _developers:
33

4-
Developer Log
4+
Developer log
55
=============
66

77
This page lists the historical members of the Python development team. (The
@@ -13,7 +13,7 @@ information.)
1313
:file: developers.csv
1414
:encoding: "utf-8"
1515

16-
Procedure for Granting or Dropping Access
16+
Procedure for granting or dropping access
1717
-----------------------------------------
1818

1919
To be granted the ability to manage who is a committer, you must be a

Diff for: core-developers/experts.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _experts:
22

33
=============
4-
Experts Index
4+
Experts index
55
=============
66

77
This document has tables that list Python Modules, Tools, Platforms and
@@ -362,7 +362,7 @@ version control merwok, ezio-melotti
362362
================== ==========================================================
363363

364364

365-
Documentation Translations
365+
Documentation translations
366366
==========================
367367

368368
For a list of translators, see :ref:`this table about translations <translating>`.

Diff for: core-developers/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
===============
2-
Core Developers
2+
Core developers
33
===============
44

55
.. toctree::

Diff for: core-developers/motivations.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _motivations:
22

33
============================
4-
Motivations and Affiliations
4+
Motivations and affiliations
55
============================
66

77
CPython core developers participate in the core development process for a

Diff for: core-developers/responsibilities.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ making design and development decisions in different areas (as documented
4444
in the :ref:`experts` and :ref:`developers`).
4545

4646

47-
Communication Channels and Bug Notifications
47+
Communication channels and bug notifications
4848
============================================
4949

5050
Mailing lists have generally been replaced by the
@@ -59,7 +59,7 @@ follow the link and click on the :guilabel:`Watch` button to set your notificati
5959

6060
.. _contributor_agreement:
6161

62-
Sign a Contributor Agreement
62+
Sign a contributor agreement
6363
============================
6464

6565
Submitting a `contributor form for Python`_ licenses any code you contribute to
@@ -77,7 +77,7 @@ username into your details on the issue tracker.
7777
.. _contributor form for Python: https://www.python.org/psf/contrib/
7878

7979

80-
Pull Request merging
80+
Pull request merging
8181
====================
8282

8383
Once you have your commit privileges on GitHub you will be able to accept

Diff for: developer-workflow/c-api.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ When in doubt, new internal C functions should be defined in
5858
``Include/internal`` using the ``extern`` keyword.
5959

6060
Private names
61-
--------------
61+
-------------
6262

6363
Any API named with a leading underscore is also considered internal.
6464
There is currently only one main use case for using such names rather than
@@ -74,7 +74,7 @@ the :ref:`unstable-capi`:
7474
* APIs for very specialized uses like JIT compilers.
7575

7676

77-
Internal API Tests
77+
Internal API tests
7878
------------------
7979

8080
C tests for the internal C API live in ``Modules/_testinternalcapi.c``.
@@ -128,7 +128,7 @@ Please start a public discussion if these guidelines won't work for your API.
128128

129129
By *return value*, we mean the value returned by the *C return statement*.
130130

131-
C API Tests
131+
C API tests
132132
-----------
133133

134134
Tests for the public C API live in the ``_testcapi`` module.
@@ -411,7 +411,7 @@ Adding a new definition to the Limited API
411411
- Add tests -- see below.
412412

413413

414-
Limited API Tests
414+
Limited API tests
415415
-----------------
416416

417417
Since Limited API is a subset of the C API, there's no need to test the

Diff for: developer-workflow/communication-channels.rst

+7-7
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
.. _communication:
33

44
==============================
5-
Following Python's Development
5+
Following Python's development
66
==============================
77

88
Python's development is communicated through a myriad of ways,
@@ -24,7 +24,7 @@ in return.
2424

2525
.. _mailinglists:
2626

27-
Mailing Lists
27+
Mailing lists
2828
=============
2929

3030
.. note:: Some mailing lists have been supplanted by categories in the
@@ -95,7 +95,7 @@ It is also the designated venue for the core developer promotion votes
9595
(as the Discourse equivalent of the `python-committers`_ mailing list).
9696

9797
Tutorials for new users
98-
-------------------------
98+
-----------------------
9999

100100
To start a topic or participate in any discussions in the forum, sign up and
101101
create an account using an email address or GitHub account. You can do so by
@@ -138,7 +138,7 @@ bottom progress bar to expand it.
138138
Notifications
139139
-------------
140140

141-
Following categories (Category notifications)
141+
Following categories (category notifications)
142142
'''''''''''''''''''''''''''''''''''''''''''''
143143

144144
Notifications can be set for individual categories and topics. To change any of these
@@ -151,7 +151,7 @@ different options: Watching, Tracking, Watching First Post, Normal, and Muted.
151151
All categories are set by default in Normal mode where you will only be notified
152152
if someone mentions your @name or replies to you.
153153

154-
Following individual threads (Topic notifications)
154+
Following individual threads (topic notifications)
155155
''''''''''''''''''''''''''''''''''''''''''''''''''
156156

157157
To follow any individual topics or threads, you can adjust your notifications
@@ -239,15 +239,15 @@ that way. You can find their blogs (and various other developers who use Python)
239239
at https://planetpython.org/.
240240

241241

242-
Setting Expectations for Open Source Participation
242+
Setting expectations for open source participation
243243
==================================================
244244

245245
Burn-out is common in open source due to a misunderstanding of what users, contributors,
246246
and maintainers should expect from each other. Brett Cannon gave a `talk <https://www.youtube.com/watch?v=-Nk-8fSJM6I>`_
247247
about this topic that sets out to help everyone set reasonable expectations of each other in
248248
order to make open source pleasant for everyone involved.
249249

250-
Additional Repositories
250+
Additional repositories
251251
=======================
252252

253253
`Python Core Workflow`_ hosts the codebase for tools such as `blurb`_.

Diff for: developer-workflow/development-cycle.rst

+8-8
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _development-cycle:
22
.. _devcycle:
33

4-
Development Cycle
4+
Development cycle
55
=================
66

77
The responsibilities of a core developer shift based on what kind of branch of
@@ -207,13 +207,13 @@ changes to the branch. After the final release is published, the full
207207
:ref:`development cycle <stages>` starts again for the next minor version.
208208

209209

210-
Repository Administration
210+
Repository administration
211211
'''''''''''''''''''''''''
212212

213213
The source code is currently hosted on `GitHub
214214
<https://github.com/python/cpython>`_ in the `Python organization <https://github.com/python/>`_.
215215

216-
Organization Repository Policy
216+
Organization repository policy
217217
------------------------------
218218

219219
Within the `GitHub Python organization <https://github.com/python/>`_,
@@ -254,7 +254,7 @@ specifically want to “bless” one implementation (as with e.g.
254254
`pythoncapi-compat <https://github.com/python/pythoncapi-compat>`_).
255255

256256

257-
Organization Owner Policy
257+
Organization owner policy
258258
-------------------------
259259

260260
The GitHub Organization Owner role allows for full management of all aspects of
@@ -281,7 +281,7 @@ Owner of the Python Organization.
281281

282282
.. _current owners:
283283

284-
Current Owners
284+
Current owners
285285
--------------
286286

287287
+----------------------+--------------------------------+-----------------+
@@ -307,7 +307,7 @@ mentioned to request assistance from an organization owner.
307307

308308
.. _be performed: https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#permissions-for-organization-roles
309309

310-
Repository Administrator Role Policy
310+
Repository administrator role policy
311311
------------------------------------
312312

313313
The Administrator role on the repository allows for managing all aspects
@@ -328,7 +328,7 @@ who no longer necessitate this level of access will be removed with notice.
328328
Multi-Factor Authentication must be enabled by the user in order to remain an
329329
Administrator of the repository.
330330

331-
Current Administrators
331+
Current administrators
332332
----------------------
333333

334334
+-------------------+----------------------------------------------------------+-----------------+
@@ -353,7 +353,7 @@ Current Administrators
353353
| Mariatta Wijaya | Maintainer of bedevere, blurb_it and miss-islington | Mariatta |
354354
+-------------------+----------------------------------------------------------+-----------------+
355355

356-
Repository Release Manager Role Policy
356+
Repository release manager role policy
357357
--------------------------------------
358358

359359
Release Managers for :ref:`in-development <indevbranch>`, :ref:`maintenance

Diff for: developer-workflow/extension-modules.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
.. _extensions:
33

44
==================================
5-
Standard Library Extension Modules
5+
Standard library extension modules
66
==================================
77

88
In this section, we could explain how to write a CPython extension with the C language, but the topic can take a complete book.

Diff for: developer-workflow/grammar.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _grammar:
22

33
==========================
4-
Changing CPython's Grammar
4+
Changing CPython's grammar
55
==========================
66

77
Abstract

Diff for: developer-workflow/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
====================
2-
Development Workflow
2+
Development workflow
33
====================
44

55
.. toctree::

Diff for: developer-workflow/lang-changes.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
.. _lang-changes:
22
.. _langchanges:
33

4-
Changing the Python Language
4+
Changing the Python language
55
============================
66
On occasion people come up with an idea on how to change or improve Python as a
77
programming language. This document is meant to explain exactly what changes
88
have a reasonable chance of being considered and what the process is to propose
99
changes to the language.
1010

1111

12-
What Qualifies
12+
What qualifies
1313
--------------
1414
First and foremost, it must be understood that changes to the Python
1515
programming language are difficult to make. When the language changes,
@@ -66,7 +66,7 @@ see `Justifying Python Language Changes`_.
6666

6767
.. _lang-changes-pep-process:
6868

69-
PEP Process
69+
PEP process
7070
-----------
7171

7272
Once you are certain you have a language change proposal

Diff for: developer-workflow/porting.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _porting:
22

33
=========================
4-
Porting to a New Platform
4+
Porting to a new platform
55
=========================
66

77
The first step is to familiarize yourself with the development toolchain on

Diff for: developer-workflow/stdlib.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _stdlib:
22
.. _stdlibchanges:
33

4-
Adding to the Stdlib
4+
Adding to the stdlib
55
====================
66

77
While the stdlib contains a great amount of useful code, sometimes you want
@@ -61,7 +61,7 @@ over other available solutions. All of this means that additions to the stdlib
6161
are not taken lightly.
6262

6363

64-
Acceptable Types of Modules
64+
Acceptable types of modules
6565
'''''''''''''''''''''''''''
6666
Typically two types of modules get added to the stdlib. One type is a module
6767
which implements something that is difficult to get right. A good example of
@@ -120,7 +120,7 @@ also helps to make sure that the overall design of the module continues to be
120120
uniform.
121121

122122

123-
Proposal Process
123+
Proposal process
124124
''''''''''''''''
125125

126126
If the module you want to propose adding to the stdlib meets the requirements,

0 commit comments

Comments
 (0)