documentation

logs/README.md

@@ -1,10 +1,16 @@
 # Logs and Reports
-Logs will collect here. Give a day of logs or a bunch of messages to have good reports.
 
-## Reporting Note
-Reporting is via [../etc/report_generator5.py](../etc/report_generator5.py). The report_generator5 has newer feel and HTML5 coding. The index.html output is published in [../etc/www](../etc/www) there is a .cfg file created on first run for configuring values as needed (like moving web root)
- - Make sure to have `SyslogToFile = True` and default of DEBUG log level to fully enable reporting! ‼️
- - If you are in a venv and using launch.sh you can `launch.sh html5`
+This directory stores log files generated by the Mesh Bot. To generate useful reports, ensure you have at least a day's worth of logs or a substantial number of messages.
+
+## Reporting
+
+Reports are generated using [`../etc/report_generator5.py`](../etc/report_generator5.py), which produces modern HTML5 reports. The output (`index.html`) is saved in [`../etc/www`](../etc/www) by default. A `.cfg` configuration file is created on first run, allowing you to customize settings such as the web root directory.
+
+- Ensure `SyslogToFile = True` and `sysloglevel = DEBUG` in your configuration to enable full reporting.
+- If using a virtual environment and `launch.sh`, you can run:  
+  ```sh
+  launch.sh html5
+  ```
 
 ![reportView](../etc/reporting.jpg)