diff --git a/README.md b/README.md
index 9faa4ee..1f581c4 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,31 @@
# Overview
| Developed by | Reflex |
-| --- | --- |
| Date of development | Feb 15, 2024 |
| Validator type | Format |
-| Blog | - |
+| Blog | |
| License | Apache 2 |
| Input/Output | Output |
-# Description
+## Description
-This validator checks if a string is valid Python syntax by trying to parse the string into an abstract syntax tree. Note that this validator doesn’t check for things such as correct argument names, etc.
+### Intended Use
+This validator checks whether a string adheres to valid Python syntax by attempting to parse it into an abstract syntax tree. Please note that it does not examine semantic elements such as correct argument names, type correctness, etc.
-## Requirements
+### Requirements
* Dependencies:
- guardrails-ai>=0.4.0
-# Installation
+## Installation
```bash
-guardrails hub install hub://reflex/valid_python
+$ guardrails hub install hub://reflex/valid_python
```
-# Usage Examples
+## Usage Examples
-## Validating string output via Python
+### Validating string output via Python
In this example, we apply the validator to a string output generated by an LLM.
@@ -35,7 +35,9 @@ from guardrails.hub import ValidPython
from guardrails import Guard
# Setup Guard
-guard = Guard().use(ValidPython, on_fail="exception")
+guard = Guard().use(
+ ValidPython, on_fail="exception"
+)
# Correct python
correct_python = """
@@ -78,7 +80,7 @@ Initializes a new instance of the ValidPython class.
-**`validate(self, value, metadata) → ValidationResult`**
+**`validate(self, value, metadata) -> ValidationResult`**