docs: add documentation of the feature

Author: tembleking

README.md

@@ -22,9 +22,9 @@ helping you detect vulnerabilities and misconfigurations earlier in the developm
 | Build and Scan Dockerfile       | Supported                                                              | [Supported](./docs/features/build_and_scan.md) (0.4.0+)                |
 | Layered image analysis          | Supported                                                              | [Supported](./docs/features/layered_analysis.md) (0.5.0+)              |
 | Docker-compose image analysis   | Supported                                                              | [Supported](./docs/features/docker_compose_image_analysis.md) (0.6.0+) |
+| Vulnerability explanation       | Supported                                                              | [Supported](./docs/features/vulnerability_explanation.md) (0.7.0+)     |
 | K8s Manifest image analysis     | Supported                                                              | In roadmap                                                             |
 | Infrastructure-as-code analysis | Supported                                                              | In roadmap                                                             |
-| Vulnerability explanation       | Supported                                                              | In roadmap                                                             |
 
 ## Build
 

docs/features/README.md

@@ -21,4 +21,8 @@ Sysdig LSP provides tools to integrate container security checks into your devel
 ## [Docker-compose Image Analysis](./docker_compose_image_analysis.md)
 - Scans the images defined in your `docker-compose.yml` files for vulnerabilities.
 
+## [Vulnerability Explanation](./vulnerability_explanation.md)
+- Displays a detailed summary of scan results when hovering over a scanned image name.
+- Provides immediate feedback on vulnerabilities, severities, and available fixes.
+
 See the linked documents for more details.

docs/features/vulnerability_explanation.gif

@@ -0,0 +1,15 @@
+# Vulnerability Explanation
+
+Sysdig LSP provides on-demand vulnerability explanations directly in your editor. After running a scan on an image (e.g., base image, Docker Compose service), you can hover over the image name to see a detailed summary of the scan results.
+
+This feature allows you to quickly assess the security posture of an image without leaving your code, displaying information such as total vulnerabilities, severity breakdown, and fixable packages in a convenient tooltip.
+
+![Sysdig LSP showing a vulnerability summary on hover](./vulnerability_explanation.gif)
+
+## How It Works
+
+1.  **Run a Scan**: Use a code action or code lens to scan an image in your `Dockerfile` or `docker-compose.yml`.
+2.  **Hover to View**: Move your cursor over the image name you just scanned.
+3.  **Get Instant Feedback**: A tooltip will appear with a formatted Markdown summary of the vulnerabilities found.
+
+This provides immediate context, helping you decide whether to update a base image or investigate a specific package.