docs: tune readme file

Author: tsypuk

README.MD

@@ -1,23 +1,33 @@
-**aws-client-monitor** is created for analysing locally running applications that are interacting with **AWS**.
+## AWS Client Monitor
 
-Very useful on local development, troubleshooting or profiling 3rd party apps.
+AWS Client Monitor is a tool designed to analyze applications interacting with AWS services. It's particularly useful during local development, troubleshooting, or profiling third-party applications.
 
-Setup is simple:
+## Features
+- Real-time Monitoring: Capture and display AWS API invocations from your applications in real-time.
+- Easy Integration: Minimal setup required; configure environment variables, and you're ready to go.
+- Dockerized Deployment: Run the monitor effortlessly using Docker.
 
-1. for each app set following environment variables:
+## Prerequisites
+Docker: Ensure Docker is installed on your system.
+
+
+## Setup Instructions
+
+1. Configure Your Application: Set the following environment variables in each application you wish to monitor:
 
 ```shell
 export AWS_CSM_ENABLED=true 
 export AWS_CSM_CLIENT_ID=my-app-service-name
 ```
 
 Optional:
+
 ```shell
 export AWS_CSM_HOST=127.0.0.1
 export AWS_CSM_PORT=31000
 ```
 
-2. Start ``aws-client-monitor``
+2. Start AWS Client Monitor: Run the monitor using Docker:
 
 ```shell
  docker run -p 8080:8080 -p 31000:31000/udp rtsypuk/aws-client-monitor:development
@@ -36,9 +46,22 @@ export AWS_CSM_PORT=31000
 2024-12-22 16:35:27 UTC [Client:subscirption-service(aws-cli/1.27.92 md/Botoco) ==========> AWS:Lambda:ListFunctions] : 226ms eu-west-1 Code:403
 
 ```
+3. Access the Dashboard: Open your browser and navigate to http://localhost:8080 to view the monitoring dashboard. 
+
+![ui_screen.png](ui.png)
+
+## How It Works
+
+Once your applications are configured and the monitor is running, any AWS SDK calls made by your applications will be captured and displayed in the AWS Client Monitor dashboard. This provides visibility into the AWS API interactions of your applications, aiding in development and troubleshooting.
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests to enhance the functionality of AWS Client Monitor.
+
+## License
 
-## Browser UI-based mode:
+This project is licensed under the MIT License. See the LICENSE file for details.
 
-Information is also available on UI (http://localhost:8080)
+## Note: 
 
-![ui_screen.png](ui.png)
+This project is not affiliated with AWS. Use it responsibly and ensure it complies with your organization's security policies.