fix contributing.md

Author: IndominusByte

docs/configuration/general.md

@@ -15,7 +15,7 @@
     Defaults to `None`
 
 `authjwt_algorithm`
-:   Which algorithm to sign the JWT with. <a href="https://pyjwt.readthedocs.io/en/latest/algorithms.html" class="external-link">See here</a>
+:   Which algorithm to sign the JWT with. <a href="https://pyjwt.readthedocs.io/en/latest/algorithms.html" class="external-link" target="_blank">See here</a>
     for the options. Defaults to `HS256`
 
 `authjwt_decode_algorithms`

docs/contributing.md

@@ -2,12 +2,71 @@
 
 This project is still quite new and therefore having your feedback will really help to
 prioritize relevant feature developments :rocket:. If you want to contribute thankss a lot :smile:, you can
-open an <a href="https://github.com/IndominusByte/fastapi-jwt-auth/issues/new">issue</a> on Github.
+open an <a href="https://github.com/IndominusByte/fastapi-jwt-auth/issues/new" target="_blank">issue</a> on Github.
 
 ## Developing
 
 If you already cloned the repository and you know that you need to deep dive in the code, here are some guidelines to set up your environment.
 
+### Virtual environment with venv
+
+You can create a virtual environment in a directory using Python's `venv` module:
+
+```bash
+$ python3 -m venv env
+```
+
+That will create a directory `./env/` with the Python binaries and then you will be able to install packages for that isolated environment.
+
+### Activate the environment
+
+```bash
+$ source ./env/bin/activate
+```
+
+To check it worked, use:
+
+```bash
+$ which pip
+
+some/directory/fastapi-jwt-auth/env/bin/pip
+```
+
+If it shows the pip binary at env/bin/pip then it worked. 🎉
+
+!!! tip
+    Every time you install a new package with `pip` under that environment, activate the environment again.
+    This makes sure that if you use a terminal program installed by that package (like `flit`),
+    you use the one from your local environment and not any other that could be installed globally.
+
+### Flit
+
+FastAPI JWT Auth uses <a href="https://flit.readthedocs.io/en/latest/index.html" class="external-link" target="_blank">Flit</a> to build, package and publish the project.
+
+After activating the environment as described above, install `flit`:
+
+```bash
+$ pip install flit
+```
+
+Now re-activate the environment to make sure you are using the `flit` you just installed (and not a global one).
+
+And now use `flit` to install the development dependencies:
+
+```bash
+$ flit install --deps develop --symlink
+```
+
+It will install all the dependencies and your local FastAPI JWT Auth in your local environment.
+
+**Using your local FastAPI JWT Auth**
+
+If you create a Python file that imports and use FastAPI JWT Auth, and run it with the Python from your local environment, it will use your localFastAPI JWT Auth source code.
+
+And if you update that local FastAPI JWT Auth source code, as it is installed with `--symlink`, when you run that Python file again, it will use the fresh version of FastAPI JWT Auth you just edited.
+
+That way, you don't have to "install" your local version to be able to test every change.
+
 ## Docs
 
 The documentation uses <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
@@ -45,7 +104,7 @@ That way, you can edit the documentation/source files and see the changes live.
 There is a script that you can run locally to test all the code and generate coverage reports in HTML:
 
 ```bash
-bash scripts/tests.sh
+$ bash scripts/tests.sh
 ```
 
 This command generates a directory `./htmlcov/`, if you open the file `./htmlcov/index.html` in your browser, you can explore interactively the regions of code that are covered by the tests, and notice if there is any region missing.

docs/usage/jwt-in-cookies.md

@@ -11,7 +11,7 @@ This isn't the full story. However now we can keep our cookies from being stolen
 <figure>
   <img src="https://miro.medium.com/max/648/1*WP_VXYjJxUyqfrul8K-4uw.png"/>
   <figcaption>
-    <a href="https://medium.com/@kaviru.mihisara/double-submit-cookie-pattern-820fc97e51f2">
+    <a href="https://medium.com/@kaviru.mihisara/double-submit-cookie-pattern-820fc97e51f2" target="_blank">
       Double Submit Cookie Pattern
     </a>
   </figcaption>

pyproject.toml

@@ -36,14 +36,14 @@ test = [
 ]
 
 doc = [
-  "mkdocs >=1.1.2,<2.0.0",
-  "mkdocs-material >=5.5.0,<6.0.0",
-  "markdown-include >=0.5.1,<0.6.0"
+  "mkdocs>=1.1.2,<2.0.0",
+  "mkdocs-material>=5.5.0,<6.0.0",
+  "markdown-include>=0.5.1,<0.6.0"
 ]
 
 dev = [
   "cryptography>=2.6,<4.0.0",
-  "uvicorn >=0.11.5,<0.12.0"
+  "uvicorn>=0.11.5,<0.12.0"
 ]
 
 asymmetric = ["cryptography>=2.6,<4.0.0"]