diff --git a/README.md b/README.md
index c580469..eb9d02a 100644
--- a/README.md
+++ b/README.md
@@ -86,18 +86,18 @@ If you wish to [collect](collect) your own dataset, there are several source fil
 
 ## Process data 
 
-raw-audit-logs.log
-main-audit-logs.log
-actions-dataset-audit.txt
+`data/raw-audit-logs.log`        Raw logs captured from Services
+`data/main-audit-logs.log`       Data logs fixed and clean
+`data/actions-dataset-audit.txt` Source content for learning models
 
-actions_distribution.pdf
+`data/actions_distribution.pdf` Generated graph view of actions / events distribution 
 
 ## Data Models 
 
 > [!CAUTION]  
 > These files are default names and paths, can be changed:
 > - by [settings](learning/python/lib_perfspec.py) modifications
-> - by <u>command-line</u> in running  script mode. Add **--help* for more info 
+> - by <u>command-line</u> in running  script mode. Add **--help** for more info 
 
 `models/checkpoints` is where files are stored as part of learning process:
 
@@ -112,14 +112,14 @@ actions_distribution.pdf
 
 ## Learning Notebooks
 
-`learning/python/lib_perfspec.py`  Main library with settings 
+[lib_perfspec.py](learning/python/lib_perfspec.py)  Main library with settings 
 
-`learning/python/prepare_perfspec.py` Prepare data from raw to source for learning models
+[prepare_perfspec.py](learning/python/prepare_perfspec.py) Prepare data from raw to source for learning models
 
-`learning/python/train_perfspec.py` To train model from data
-`learning/python/run_perfspec.py`   To run/check predictions
+[train_perfspec.py](learning/python/train_perfspec.py)_ To train model from data
+[run_perfspec.py](learning/python/run_perfspec.py)   To run/check predictions
 
-`learning/python/model_perfspec.py` To inspect / review generated models
+[model_perfspec.py](`learning/python/model_perfspec.py` To inspect / review generated models
 
 <small>  __ pycache __ is for Python execution,  is  ignored in git tasks.</small>