diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index e18d85cebde0..d5f491a82563 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -25,11 +25,12 @@ Fork the Matplotlib repository
 ==============================
 
 Matplotlib is hosted at https://github.com/matplotlib/matplotlib.git. If you
-plan on solving issues or submit pull requests to the main Matplotlib
+plan on solving issues or submitting pull requests to the main Matplotlib
 repository, you should first *fork* this repository by visiting
 https://github.com/matplotlib/matplotlib.git and clicking on the
-``Fork`` button on the top right of the page (see
-`the GitHub documentation <https://docs.github.com/get-started/quickstart/fork-a-repo>`__ for more details.)
+``Fork`` :octicon:`repo-forked` button on the top right of the page. See
+`the GitHub documentation <https://docs.github.com/get-started/quickstart/fork-a-repo>`__
+for more details.
 
 Retrieve the latest version of the code
 =======================================
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index 3f4fe956e37e..edb21bb862cd 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -162,10 +162,10 @@ history clean.
 
 You can achieve this by using
 
-  .. code-block:: bash
+.. code-block:: bash
 
-     git commit -a --amend --no-edit
-     git push [your-remote-repo] [your-branch] --force-with-lease
+    git commit -a --amend --no-edit
+    git push [your-remote-repo] [your-branch] --force-with-lease
 
 
 Manage commit history