File tree Expand file tree Collapse file tree 4 files changed +32
-4
lines changed
Filter options
Expand file tree Collapse file tree 4 files changed +32
-4
lines changed
Original file line number Diff line number Diff line change @@ -340,10 +340,14 @@ then submit a "pull request" (PR). To work on a a pull request:
340
340
Matplotlib repository to your own computer or by using Github codespaces, by
341
341
following the instructions in :ref: `installing_for_devs `
342
342
343
- #. **Then ** start a pull request by following the guidance in :ref: `development workflow <development-workflow >`
344
-
345
- #. **After starting ** check that your contribution meets the :ref: `pull request guidelines <pr-author-guidelines >`
346
- and :ref: `update the pull request <update-pull-request >` as needed.
343
+ #. **Then ** start working on the problem by following the guidance in
344
+ :ref: `development workflow <development-workflow >`
345
+
346
+ #. **When you are happy with your change ** check that your contribution meets
347
+ the :ref: `pull request guidelines <pr-author-guidelines >`
348
+ and then :ref: `open a pull request <open-pull-request >`. If anything does
349
+ not look quite right, you can
350
+ :ref: `update the pull request <update-pull-request >` as needed.
347
351
348
352
#. **Finally ** follow up with maintainers on the PR if waiting more than a few days for
349
353
feedback.
Original file line number Diff line number Diff line change @@ -146,6 +146,26 @@ The editing workflow
146
146
.. _why the -a flag? : http://gitready.com/beginner/2009/01/18/the-staging-area.html
147
147
148
148
149
+ Verify your changes
150
+ ===================
151
+
152
+ Check that your change does what you intend. For code changes:
153
+
154
+ * If the issue you are working on provided a code example, run that example
155
+ against your branch and check that you now get the desired result.
156
+
157
+ * Run the tests to check that your change has not had unintended consequences
158
+ on existing functionality. See :ref: `run_tests `.
159
+
160
+ For documentation changes you can build the documentation locally to check that
161
+ it renders how you intended and any new links work correctly. See
162
+ :ref: `build_docs `.
163
+
164
+ This is also a good time to look through the :ref: `pr-author-guidelines ` and
165
+ address as many of the relevant points as you can.
166
+
167
+ .. _open-pull-request :
168
+
149
169
Open a pull request
150
170
===================
151
171
Original file line number Diff line number Diff line change @@ -52,6 +52,8 @@ To build the documentation you will need to
52
52
particular the :ref: `additional dependencies <doc-dependencies >` required to
53
53
build the documentation.
54
54
55
+ .. _build_docs :
56
+
55
57
Build the docs
56
58
--------------
57
59
Original file line number Diff line number Diff line change @@ -32,6 +32,8 @@ particular the :ref:`additional dependencies <test-dependencies>` for testing.
32
32
You have to additionally get the reference images from the repository,
33
33
because they are not distributed with pre-built Matplotlib packages.
34
34
35
+ .. _run_tests :
36
+
35
37
Running the tests
36
38
-----------------
37
39
You can’t perform that action at this time.
0 commit comments