DOC: Make FAQ titles

1 files changed, 64 insertions, 54 deletions

diff --git a/doc/source/dev/development_gitpod.rst b/doc/source/dev/development_gitpod.rst
index ba80bb266..92cca81fc 100644
--- a/doc/source/dev/development_gitpod.rst
+++ b/doc/source/dev/development_gitpod.rst
@@ -35,7 +35,7 @@ Make sure to select **All repositories** access option to avoid issues with
 permissions later on. Click on the green **Install** button
 
 .. image:: ./gitpod-imgs/installing-gitpod-io.png
-    :alt: Gitpod repository access and installation screenshot
+   :alt: Gitpod repository access and installation screenshot
 
 This will install the necessary hooks for the integration.
 
@@ -57,7 +57,7 @@ which will add a **Gitpod** button next to the **Code** button in the
 repository:
 
 .. image:: ./gitpod-imgs/NumPy-github.png
-    :alt: NumPy repository with Gitpod button screenshot
+   :alt: NumPy repository with Gitpod button screenshot
 
 #. If you install the extension - you can click the **Gitpod** button to start 
    a new workspace.
@@ -79,7 +79,7 @@ repository:
 #. When your workspace is ready, you can :ref:`test the build<testing-builds>` by 
    entering::
 
-        $ python runtests.py -v
+      $ python runtests.py -v
 
 ``runtests.py`` is another script in the NumPy root directory. It runs a suite 
 of tests that make sure NumPy is working as it should, and ``-v`` activates the 
@@ -93,11 +93,11 @@ can check the Getting started `VSCode docs`_ to familiarize yourself with it.
 Your workspace will look similar to the image below:
 
 .. image:: ./gitpod-imgs/gitpod-workspace.png
-    :alt: Gitpod workspace screenshot
+   :alt: Gitpod workspace screenshot
 
 .. note::  By default, VSCode initializes with a light theme. You can change to 
-    a dark theme by with the keyboard shortcut :kbd:`Cmd-K Cmd-T` in Mac or 
-    :kbd:`Ctrl-K Ctrl-T` in Linux and Windows.
+   a dark theme by with the keyboard shortcut :kbd:`Cmd-K Cmd-T` in Mac or 
+   :kbd:`Ctrl-K Ctrl-T` in Linux and Windows.
 
 We have marked some important sections in the editor:
 
@@ -109,7 +109,7 @@ We have marked some important sections in the editor:
 #. GitHub Pull Requests extension - you can use this to work with Pull Requests 
    from your workspace.
 #. Marketplace extensions - we have added some essential extensions to the NumPy 
-#. Gitpod. Still, you can also install other extensions or syntax highlighting 
+   Gitpod. Still, you can also install other extensions or syntax highlighting 
    themes for your user, and these will be preserved for you.
 #. Your workspace directory - by default, it is ``/workspace/numpy``. **Do not 
    change this** as this is the only directory preserved in Gitpod.
@@ -136,12 +136,12 @@ When using Gitpod, git is pre configured for you:
    done for you as you authenticated through GitHub. You can check the git 
    configuration with the command ``git config --list`` in your terminal.
 #. As you started your workspace from your own NumPy fork, you will by default 
-   have both "upstream "and "origin "added as remotes. You can verify this by 
+   have both ``upstream`` and ``origin`` added as remotes. You can verify this by 
    typing ``git remote`` on your terminal or by clicking on the **branch name** 
    on the status bar (see image below).
 
-.. image:: ./gitpod-imgs/NumPy-gitpod-branches.png
-    :alt: Gitpod workspace branches plugin screenshot
+   .. image:: ./gitpod-imgs/NumPy-gitpod-branches.png
+      :alt: Gitpod workspace branches plugin screenshot
 
 Rendering the NumPy documentation
 ----------------------------------
@@ -188,8 +188,7 @@ uses the rst extension with docutils.
     .. image:: ./gitpod-imgs/vscode-rst.png
         :alt: Gitpod workspace VSCode open rst screenshot
 
-#. As you work on the document, you will see a live rendering of it on the 
-    editor.
+#. As you work on the document, you will see a live rendering of it on the editor.
 
     .. image:: ./gitpod-imgs/rst-rendering.png
         :alt: Gitpod workspace VSCode rst rendering screenshot
@@ -200,60 +199,71 @@ rebuild the docs with ``make html`` and use Live Serve as described in option 1.
 FAQ's and troubleshooting
 -------------------------
 
-#. How long is my Gitpod workspace kept for?
-    Your stopped workspace will be kept for 14 days and deleted afterwards if 
-    you do not use them.
+How long is my Gitpod workspace kept for?
+*****************************************
 
-#. Can I come back to a previous workspace?
-    Yes, let's say you stepped away for a while and you want to carry on working 
-    on your NumPy contributions. You need to visit https://gitpod.io/workspaces 
-    and click on the workspace you want to spin up again. All your changes will 
-    be there as you last left them.
+Your stopped workspace will be kept for 14 days and deleted afterwards if you do 
+not use them.
 
-#. Can I install additional VSCode extensions?
-    Absolutely! Any extensions you installed will be installed in your own 
-    workspace and preserved.
+Can I come back to a previous workspace?
+*****************************************
 
-#. I registered on Gitpod but I still cannot see a ``Gitpod`` button in my repositories.
-    Head to https://gitpod.io/integrations and make sure you are logged in. 
-    Hover over GitHub and click on the three buttons that appear on the right. 
-    Click on edit permissions and make sure you have ``user:email``, 
-    ``read:user``, and ``public_repo`` checked. Click on **Update Permissions** 
-    and confirm the changes in the GitHub application page.
+Yes, let's say you stepped away for a while and you want to carry on working on 
+your NumPy contributions. You need to visit https://gitpod.io/workspaces and 
+click on the workspace you want to spin up again. All your changes will be there 
+as you last left them.
 
-    .. image:: ./gitpod-imgs/gitpod-edit-permissions-gh.png
-        :alt: Gitpod integrations - edit GH permissions screenshot
+Can I install additional VSCode extensions?
+*******************************************
 
-#. How long does my workspace stay active if I'm not using it?
-    If you keep your workspace open in a browser tab but don't interact with it, 
-    it will shut down after 30 minutes. If you close the browser tab, it will 
-    shut down after 3 minutes.
+Absolutely! Any extensions you installed will be installed in your own workspace 
+and preserved.
 
-#. My terminal is blank - there is no cursor and it's completely unresponsive
+I registered on Gitpod but I still cannot see a ``Gitpod`` button in my repositories.
+*************************************************************************************
 
-    Unfortunately this is a known-issue on Gitpod's side. You can sort this 
-    issue in two ways:
+Head to https://gitpod.io/integrations and make sure you are logged in. 
+Hover over GitHub and click on the three buttons that appear on the right. 
+Click on edit permissions and make sure you have ``user:email``, 
+``read:user``, and ``public_repo`` checked. Click on **Update Permissions** 
+and confirm the changes in the GitHub application page.
 
-    #. Create a new Gitpod workspace altogether.
-    #. Head to your `Gitpod dashboard <https://gitpod.io/workspaces>`_ and locate 
-       the running workspace. Hover on it and click on the **three dots menu** 
-       and then click on **Stop**. When the workspace is completely stopped you 
-       can click on its name to restart it again.   
+.. image:: ./gitpod-imgs/gitpod-edit-permissions-gh.png
+   :alt: Gitpod integrations - edit GH permissions screenshot
 
-       .. image:: ./gitpod-imgs/gitpod-dashboard-stop.png
-           :alt: Gitpod dashboard and workspace menu screenshot
+How long does my workspace stay active if I'm not using it?
+***********************************************************
 
-#. I authenticated through GitHub but I still cannot commit to the repository 
-   through Gitpod. 
+If you keep your workspace open in a browser tab but don't interact with it, 
+it will shut down after 30 minutes. If you close the browser tab, it will 
+shut down after 3 minutes.
 
-    Head to https://gitpod.io/integrations and make sure you are logged in. 
-    Hover over GitHub and click on the three buttons that appear on the right. 
-    Click on edit permissions and make sure you have ``public_repo`` checked.
-    Click on **Update Permissions** and confirm the changes in the 
-    GitHub application page.
+My terminal is blank - there is no cursor and it's completely unresponsive
+**************************************************************************
 
-    .. image:: ./gitpod-imgs/gitpod-edit-permissions-repo.png
-        :alt: Gitpod integrations - edit GH repository permissions screenshot
+Unfortunately this is a known-issue on Gitpod's side. You can sort this 
+issue in two ways:
+
+#. Create a new Gitpod workspace altogether.
+#. Head to your `Gitpod dashboard <https://gitpod.io/workspaces>`_ and locate 
+   the running workspace. Hover on it and click on the **three dots menu** 
+   and then click on **Stop**. When the workspace is completely stopped you 
+   can click on its name to restart it again.   
+
+.. image:: ./gitpod-imgs/gitpod-dashboard-stop.png
+   :alt: Gitpod dashboard and workspace menu screenshot
+
+I authenticated through GitHub but I still cannot commit to the repository through Gitpod. 
+******************************************************************************************
+
+Head to https://gitpod.io/integrations and make sure you are logged in. 
+Hover over GitHub and click on the three buttons that appear on the right. 
+Click on edit permissions and make sure you have ``public_repo`` checked.
+Click on **Update Permissions** and confirm the changes in the 
+GitHub application page.
+
+.. image:: ./gitpod-imgs/gitpod-edit-permissions-repo.png
+   :alt: Gitpod integrations - edit GH repository permissions screenshot
 
 .. _Gitpod: https://www.gitpod.io/
 .. _NumPy repository on GitHub: https://github.com/NumPy/NumPy