doc: add multiple setup options

Author: fruitymedley

Diff for: CONTRIBUTING.rst

@@ -102,51 +102,63 @@ and use Python's built-in web server for a preview in your web browser
 
     python3 -m http.server --directory 'docs/_build/html'
 
+Project Setup
+=============
 
-Code Contributions
-==================
+Clone the repository
+--------------------
 
-.. todo:: Please include a reference or explanation about the internals of the project.
+#. Create an user account on |the repository service| if you do not already have one.
+#. Fork the project repository_: click on the *Fork* button near the top of the
+   page. This creates a copy of the code under your account on |the repository service|.
+#. Clone this copy to your local disk::
 
-   An architecture description, design principles or at least a summary of the
-   main concepts will make it easy for potential contributors to get started
-   quickly.
+    git clone [email protected]:YourLogin/strawberry-sqlalchemy-mapper.git
+    cd strawberry-sqlalchemy-mapper
 
-Submit an issue
----------------
+Install dependencies and plugins
+--------------------------------
 
-Before you work on any non-trivial code contribution it's best to first create
-a report in the `issue tracker`_ to start a discussion on the subject.
-This often provides additional considerations and avoids unnecessary work.
+There are two ways to set up the environment for local development:
 
-Create an environment
----------------------
+#. Manual environment setup
 
-Before you start coding, we recommend creating an isolated `virtual
-environment`_ to avoid any problems with your installed Python packages.
-This can easily be done via either |virtualenv|_::
+#. Dev Container setup
 
-    virtualenv <PATH TO VENV>
-    source <PATH TO VENV>/bin/activate
+Method 1: Manual environment setup
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-or Miniconda_::
+#. Before you start coding, we recommend creating an isolated `virtual
+   environment`_ to avoid any problems with your installed Python packages.
+   This can easily be done via either |virtualenv|_::
 
-    conda create -n strawberry-sqlalchemy-mapper python=3 six virtualenv pytest pytest-cov
-    conda activate strawberry-sqlalchemy-mapper
+      virtualenv <PATH TO VENV>
+      source <PATH TO VENV>/bin/activate
 
-Clone the repository
---------------------
+   or Miniconda_::
 
-#. Create an user account on |the repository service| if you do not already have one.
-#. Fork the project repository_: click on the *Fork* button near the top of the
-   page. This creates a copy of the code under your account on |the repository service|.
-#. Clone this copy to your local disk::
+      conda create -n strawberry-sqlalchemy-mapper python=3 six virtualenv pytest pytest-cov
+      conda activate strawberry-sqlalchemy-mapper
 
-    git clone [email protected]:YourLogin/strawberry-sqlalchemy-mapper.git
-    cd strawberry-sqlalchemy-mapper
+#. You should run::
 
-Open the Dev Container
-----------------------
+    pip install -U pip setuptools -e .
+
+   to be able to import the package under development in the Python REPL.
+
+   .. todo:: if you are not using pre-commit, please remove the following item:
+
+#. Install |pre-commit|_::
+
+    pip install pre-commit
+    pre-commit install
+
+   ``strawberry-sqlalchemy-mapper`` comes with a lot of hooks configured to automatically help the
+   developer to check the code being written.
+
+
+Method 2: Dev Container setup
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 #. Install `Dev Containers`_.
 
@@ -160,6 +172,22 @@ Open the Dev Container
 #. Select the environment labeled 'poetry'.
 
 
+Code Contributions
+==================
+
+.. todo:: Please include a reference or explanation about the internals of the project.
+
+   An architecture description, design principles or at least a summary of the
+   main concepts will make it easy for potential contributors to get started
+   quickly.
+
+Submit an issue
+---------------
+
+Before you work on any non-trivial code contribution it's best to first create
+a report in the `issue tracker`_ to start a discussion on the subject.
+This often provides additional considerations and avoids unnecessary work.
+
 Implement your changes
 ----------------------