Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 241c211

Browse filesBrowse files
committed
DOC: verify your changes
1 parent 7293157 commit 241c211
Copy full SHA for 241c211

File tree

Expand file treeCollapse file tree

4 files changed

+32
-4
lines changed
Filter options
Expand file treeCollapse file tree

4 files changed

+32
-4
lines changed

‎doc/devel/contribute.rst

Copy file name to clipboardExpand all lines: doc/devel/contribute.rst
+8-4Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -340,10 +340,14 @@ then submit a "pull request" (PR). To work on a a pull request:
340340
Matplotlib repository to your own computer or by using Github codespaces, by
341341
following the instructions in :ref:`installing_for_devs`
342342

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.
347351

348352
#. **Finally** follow up with maintainers on the PR if waiting more than a few days for
349353
feedback.

‎doc/devel/development_workflow.rst

Copy file name to clipboardExpand all lines: doc/devel/development_workflow.rst
+20Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,26 @@ The editing workflow
146146
.. _why the -a flag?: http://gitready.com/beginner/2009/01/18/the-staging-area.html
147147

148148

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+
149169
Open a pull request
150170
===================
151171

‎doc/devel/document.rst

Copy file name to clipboardExpand all lines: doc/devel/document.rst
+2Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ To build the documentation you will need to
5252
particular the :ref:`additional dependencies <doc-dependencies>` required to
5353
build the documentation.
5454

55+
.. _build_docs:
56+
5557
Build the docs
5658
--------------
5759

‎doc/devel/testing.rst

Copy file name to clipboardExpand all lines: doc/devel/testing.rst
+2Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,8 @@ particular the :ref:`additional dependencies <test-dependencies>` for testing.
3232
You have to additionally get the reference images from the repository,
3333
because they are not distributed with pre-built Matplotlib packages.
3434

35+
.. _run_tests:
36+
3537
Running the tests
3638
-----------------
3739

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.