doc updates

Author: oleks-dev

docs/how-to/install-templates.md

@@ -9,20 +9,24 @@ Templates are stored in this [github prich-templates repository](https://www.git
 - **List Available Remote Templates for Installation**
 
     ```bash
+    # list all remote templates
     prich list --remote
     ```
 
     ```bash
+    # filter remote templates using tags
     prich list --remote --tag code --tag review
     ```
 
 - **Install Template from *prich-templates* Repository**
 
     ```bash
+    # install in current prich folder
     prich install <template_id> --remote
     ```
 
     ```bash
+    # install in home prich folder
     prich install <template_id> --remote --global
     ```
 
@@ -47,7 +51,10 @@ This copies files, sets up venvs, and installs dependencies - if python is used
 To reinstall template use `--force` flag together with the selected install template, this will reinstall the template and it's isolated venv (if any).
 
 ```bash
+# from remote repo
 prich install code-review --remote --force
+# from local folder
 prich install ./code-review --force
+# from archive file
 prich install code-review.zip --force
 ```

docs/how-to/install.md

@@ -3,13 +3,16 @@
 
 Until prich is published on PyPI, you can install it directly from GitHub.
 
-**Recommended: Use `pipx`**
+**Recommended: Use `pipx`**  
+> Make sure pipx is installed  
+> `pip install pipx && pipx ensurepath`  
+> or  
+> `brew install pipx && pipx ensurepath`  
+
 ```bash
 pipx install git+https://github.com/oleks-dev/prich
 ```
-
 > This installs prich in an isolated environment, ideal for CLI tools.  
-> Make sure pipx is installed (`pip install pipx && pipx ensurepath`).
 
 **Alternative: Use `uv`**
 ```bash
@@ -44,7 +47,7 @@ pipx install git+https://github.com/oleks-dev/prich --force
 ### **Initialize prich**
 **prich** uses nodejs-like home/local folder configurations for flexible usage of the configs and templates per project.  
 
-   - Local folder based
+   - Local (current) folder based
        ```bash
        prich init
        ```

docs/reference/template/steps.md

@@ -77,7 +77,7 @@ steps:
 ##### Extract variables  
 ```yaml
     # create variables with extracted text from output
-    extract_vars:                      # optional [list[dict]]
+    extract_variables:                 # optional [list[dict]]
 
       # extract value using regex 
       # (same regex rules as in `output_regex`)
@@ -90,7 +90,7 @@ steps:
         multiple: false                # optional [bool]
 ```
 
-> **Note:** When extracting variables with `extract_vars` the full initial output text is used (before transformations)  
+> **Note:** When extracting variables with `extract_variables` the full initial output text is used (before transformations)  
 
 
 ##### Validate output