Apply suggestions from code review

Co-authored-by: Rafał Pitoń <[email protected]>

README.md

@@ -46,15 +46,15 @@ and navigate to http://127.0.0.1:8000
 
 ### Tests
 
-With the following command you can run tests: 
+To run tests suite use the following command: 
 
 ```
 hatch run test 
 ```
 
-### Code style
+### Code style and linters
 
-This library follows a specific style guide, to achieve the proper format and lint the code the following commands should be used:
+Use the following commands to format the code and lint it for issues:
 
 ```
 hatch run lint:fmt

docs/index.md

@@ -18,7 +18,9 @@ pip install saleor-sdk-python
 
 ## Key features
 
-- 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
+- CLI tools automating common development tasks: testing, linting and publication.
+- CLI utility for deserializing Saleor's GraphQL IDs values to reveal type names and their database IDs - helpful in debugging and local development.
+- 
 - 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...