chore: adding better infos in Readme about the docs

Author: florianow

README.md

@@ -19,6 +19,24 @@ To run this module, you need the following:
   2. Privileged Role Administrator AND (Cloud) Application Administrator
 - Permissions on Azure Resource Level: User Access Administrator on the Management Group that should be managed by meshStack
 
+## Documentation
+
+This module automatically generates comprehensive documentation about your deployment. After running `terraform apply`, you can view detailed information about your configuration:
+
+```bash
+# View documentation in terminal
+terraform output -json meshplatform | jq -r '.documentation'
+
+# Save documentation to markdown file
+terraform output -json meshplatform | jq -r '.documentation' > meshplatform-docs.md
+```
+
+The documentation includes:
+- Service principal deployment status and IDs
+- Configuration details and scopes
+- meshStack integration information
+- Available terraform commands for your specific setup
+
 ## How to Use This Module
 
 ### Using Azure Portal