|
46 | 46 | DOCS_SERVER = "docs.nyc1.psf.io" |
47 | 47 |
|
48 | 48 | WHATS_NEW_TEMPLATE = """ |
49 | | -**************************** |
| 49 | +***************************** |
50 | 50 | What's new in Python {version} |
51 | | -**************************** |
| 51 | +***************************** |
52 | 52 |
|
53 | 53 | :Editor: TBD |
54 | 54 |
|
55 | 55 | .. Rules for maintenance: |
56 | 56 |
|
57 | | - * Anyone can add text to this document. Do not spend very much time |
58 | | - on the wording of your changes, because your text will probably |
59 | | - get rewritten to some degree. |
60 | | -
|
61 | | - * The maintainer will go through Misc/NEWS periodically and add |
62 | | - changes; it's therefore more important to add your changes to |
63 | | - Misc/NEWS than to this file. |
64 | | -
|
65 | 57 | * This is not a complete list of every single change; completeness |
66 | | - is the purpose of Misc/NEWS. Some changes I consider too small |
67 | | - or esoteric to include. If such a change is added to the text, |
68 | | - I'll just remove it. (This is another reason you shouldn't spend |
69 | | - too much time on writing your addition.) |
70 | | -
|
71 | | - * If you want to draw your new text to the attention of the |
72 | | - maintainer, add 'XXX' to the beginning of the paragraph or |
73 | | - section. |
74 | | -
|
75 | | - * It's OK to just add a fragmentary note about a change. For |
76 | | - example: "XXX Describe the transmogrify() function added to the |
77 | | - socket module." The maintainer will research the change and |
78 | | - write the necessary text. |
79 | | -
|
80 | | - * You can comment out your additions if you like, but it's not |
81 | | - necessary (especially when a final release is some months away). |
| 58 | + is the purpose of Misc/NEWS. The editor may remove changes they |
| 59 | + consider too small or esoteric to include. |
82 | 60 |
|
83 | | - * Credit the author of a patch or bugfix. Just the name is |
| 61 | + * Credit the author of a patch or bugfix. Just the name is |
84 | 62 | sufficient; the e-mail address isn't necessary. |
85 | 63 |
|
86 | 64 | * It's helpful to add the issue number as a comment: |
|
89 | 67 | module. |
90 | 68 | (Contributed by P.Y. Developer in :gh:`12345`.) |
91 | 69 |
|
92 | | - This saves the maintainer the effort of going through the VCS log |
93 | | - when researching a change. |
94 | | -
|
95 | 70 | This article explains the new features in Python {version}, compared to {prev_version}. |
96 | 71 |
|
97 | 72 | For full details, see the :ref:`changelog <changelog>`. |
|
113 | 88 | .. PEP-sized items next. |
114 | 89 |
|
115 | 90 |
|
116 | | -
|
117 | 91 | New features |
118 | 92 | ============ |
119 | 93 |
|
120 | 94 |
|
121 | | -
|
122 | 95 | Other language changes |
123 | 96 | ====================== |
124 | 97 |
|
125 | 98 |
|
126 | | -
|
127 | 99 | New modules |
128 | 100 | =========== |
129 | 101 |
|
|
140 | 112 |
|
141 | 113 | .. Add improved modules above alphabetically, not here at the end. |
142 | 114 |
|
| 115 | +
|
143 | 116 | Optimizations |
144 | 117 | ============= |
145 | 118 |
|
|
149 | 122 | * TODO |
150 | 123 |
|
151 | 124 |
|
152 | | -
|
153 | 125 | Removed |
154 | 126 | ======= |
155 | 127 |
|
156 | 128 | module_name |
157 | 129 | ----------- |
158 | 130 |
|
159 | 131 | * TODO |
| 132 | +
|
160 | 133 | .. Add removals above alphabetically, not here at the end. |
161 | 134 |
|
162 | 135 |
|
|
166 | 139 | * module_name: |
167 | 140 | TODO |
168 | 141 |
|
169 | | -
|
170 | 142 | .. Add deprecations above alphabetically, not here at the end. |
171 | 143 |
|
172 | 144 |
|
|
189 | 161 |
|
190 | 162 | * TODO |
191 | 163 |
|
| 164 | +
|
192 | 165 | Porting to Python {version} |
193 | 166 | ---------------------- |
194 | 167 |
|
195 | 168 | * TODO |
196 | 169 |
|
| 170 | +
|
197 | 171 | Deprecated C APIs |
198 | 172 | ----------------- |
199 | 173 |
|
200 | 174 | * TODO |
201 | 175 |
|
202 | 176 | .. Add C API deprecations above alphabetically, not here at the end. |
203 | 177 |
|
| 178 | +
|
204 | 179 | Removed C APIs |
205 | 180 | -------------- |
206 | | -
|
207 | 181 | """ |
208 | 182 |
|
209 | 183 |
|
|
0 commit comments