update docs installation
authorClaromes <claromes@hey.com>
Thu, 4 Jul 2024 19:34:46 +0000 (16:34 -0300)
committerClaromes <claromes@hey.com>
Thu, 4 Jul 2024 19:34:46 +0000 (16:34 -0300)
docs/contribute.rst
docs/installation.rst

index 54376ac89517c7a6447d7cc3ebf2d7fa92890cda..edaab0c77b6d9f9692ec0022770f49c9023a5df1 100644 (file)
@@ -19,7 +19,7 @@ These are the prerequisites:
 - Python 3.10+
 - Poetry
 
-Install from the source, following the :ref:`installation` instructions.
+Install from the source, following the :ref:`installation_from_source` instructions.
 
 Brief explanation about the code under the Wayback Tweets directory:
 
index 52e614d33425f5647472803cabc86d279412ac3a..dd35b7ae3f46c78a5d4714c3e612162469c4f7ef 100644 (file)
@@ -1,8 +1,7 @@
-.. _installation:
-
 Installation
 ================
 
+**It is compatible with Python versions 3.10 and above.**
 
 Using pip
 ------------
@@ -11,47 +10,68 @@ Using pip
 
         pip install waybacktweets
 
+Using Poetry
+------------
+
+    .. code-block:: shell
+
+        poetry add waybacktweets
+
+.. _installation_from_source:
+
 From source
 -------------
 
-    Clone the repository:
+    **Clone the repository:**
 
     .. code-block:: shell
 
         git clone git@github.com:claromes/waybacktweets.git
 
-    Change directory:
+    **Change directory:**
 
     .. code-block:: shell
 
         cd waybacktweets
 
-    Install poetry, if you haven't already:
+    **Install Poetry, if you haven't already:**
 
     .. code-block:: shell
 
         pip install poetry
 
 
-    Install the dependencies:
+    **Install the dependencies:**
 
     .. code-block:: shell
 
         poetry install
 
-    Run the CLI:
+    **Install the pre-commit:**
+
+    .. code-block:: shell
+
+        poetry run pre-commit install
+
+    **Run the CLI:**
 
     .. code-block:: shell
 
         poetry run waybacktweets [SUBCOMMANDS]
 
-    Run the Streamlit App:
+    **Starts a new shell and activates the virtual environment:**
+
+    .. code-block:: shell
+
+        poetry shell
+
+    **Run the Streamlit App:**
 
     .. code-block:: shell
 
         streamlit run app/app.py
 
-    Build the docs:
+    **Build the docs:**
 
     .. code-block:: shell