add index page for docs

README.md

@@ -30,10 +30,14 @@ saleor-sdk tools encode-id User 22
 
 ## Development
 
+To contribute to this repository you will need Hatch to setup a local development environment. 
+
 Install [Hatch](https://hatch.pypa.io/latest/install/#pipx).
 
 ### Documentation
 
+You can deploy a local documentation service, it reloads changes and allow for a live preview of how the documentation will look like after publication:
+
 ```
 hatch run docs:serve
 ```
@@ -42,20 +46,27 @@ and navigate to http://127.0.0.1:8000
 
 ### Tests
 
+With the following command you can run tests: 
+
 ```
 hatch run test 
 ```
 
-### Build and deploy
+### Code style
+
+This library follows a specific style guide, to achieve the proper format and lint the code the following commands should be used:
 
 ```
-hatch build -c
-hatch publish
+hatch run lint:fmt
+hatch run lint:all
 ```
 
-### Code style
+
+### Build and deploy
+
+This is done by a CI/CD workflow upon the creation of a release but in case of the need for a manual publication of the packager to PyPI you need to build the package archive and publish it. 
 
 ```
-hatch run lint:fmt
-hatch run lint:all
+hatch build -c
+hatch publish
 ```

docs/index.md

@@ -18,8 +18,8 @@ pip install saleor-sdk-python
 
 ## Key features
 
-- CLI with tooling that helps to decode Saleor IDs
-- Crypto module helping with Saleor authentication, both JWT verification and webhook signature verification
+- CLI with tooling that helps to decode and encode Saleor IDs - this is useful when a entity type or ID needs to be recognized from a GraphQL ID
+- Crypto module helping with Saleor authentication, both JWT verification and webhook signature verification - provides a way to manage Saleor issued signatures
 - Marina module - more on that in a later time...
 
 ## Best served with