@@ -227,6 +227,9 @@ Maplotlib repository to your own computer, or alternatively using
227227in-browser development environment that comes with the appropriated setup to
228228contribute to Matplotlib.
229229
230+ Workflow overview
231+ ^^^^^^^^^^^^^^^^^
232+
230233A brief overview of the workflow is as follows.
231234
232235#. `Create an account <https://github.com/join >`_ on GitHub if you do not
@@ -289,14 +292,19 @@ A brief overview of the workflow is as follows.
289292
290293 git push -u origin my-feature
291294
292- Finally, go to the web page of your fork of the Matplotlib repo, and click
293- 'Pull request' to send your changes to the maintainers for review.
295+ Open a pull request on Matplotlib
296+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
297+ Finally, go to the web page of *your fork * of the Matplotlib repo, and click
298+ **Compare & pull request ** to send your changes to the maintainers for review.
299+ The base repository is ``matplotlib/matplotlib `` and the base branch is
300+ generally ``main ``. For more guidance, see GitHub's `pull request tutorial
301+ <https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork> `_.
294302
295303For more detailed instructions on how to set up Matplotlib for development and
296304best practices for contribution, see:ref: `installing_for_devs `.
297305
298306GitHub Codespaces workflows
299- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
307+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
300308
301309* If you need to open a GUI window with Matplotlib output on Codespaces, our
302310 configuration includes a `light-weight Fluxbox-based desktop
@@ -378,7 +386,7 @@ This ensures that users are notified before the change will take effect and thus
378386prevents unexpected breaking of code.
379387
380388Rules
381- ~~~~~
389+ ^^^^^
382390
383391- Deprecations are targeted at the next point.release (e.g. 3.x)
384392- Deprecated API is generally removed two point-releases after introduction
@@ -391,7 +399,7 @@ Rules
391399 API consistency lead developer
392400
393401Introducing
394- ~~~~~~~~~~~
402+ ^^^^^^^^^^^
395403
396404#. Announce the deprecation in a new file
397405:file: `doc/api/next_api_changes/deprecations/99999-ABC.rst ` where ``99999 ``
@@ -432,7 +440,7 @@ Introducing
432440 version number.
433441
434442Expiring
435- ~~~~~~~~
443+ ^^^^^^^^
436444
437445#. Announce the API changes in a new file
438446:file: `doc/api/next_api_changes/[kind]/99999-ABC.rst ` where ``99999 ``
@@ -613,7 +621,7 @@ example, use ``_log.error('hello %s', 'world')`` rather than ``_log.error('hell
613621{}'.format('world')) `` or ``_log.error(f'hello {s}') ``.
614622
615623Which logging level to use?
616- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
624+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
617625
618626There are five levels at which you can emit messages.
619627