docs: add Vale documentation for quality checks and update .gitignore

Author: Le-Caignec

.github/workflows/vale.yml

@@ -0,0 +1,18 @@
+name: Documentation Quality
+
+on:
+  pull_request:
+
+jobs:
+  vale:
+    name: Vale Documentation Quality Check
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Run Vale
+        uses: errata-ai/[email protected]
+        with:
+          files: src/

.gitignore

@@ -12,3 +12,6 @@ components.d.ts
 
 #mac
 .DS_Store
+
+#vale
+.github/styles/*

.vale.ini

@@ -0,0 +1,10 @@
+StylesPath = .github/styles
+MinAlertLevel = suggestion
+Packages = Google
+
+[formats]
+md = markdown
+
+[*.md]
+BasedOnStyles = Vale, Google
+IgnorePatterns = README.md

README.md

@@ -4,9 +4,59 @@
 
 - **Node.js**: Version 22 or higher
 - **npm**: Comes bundled with Node.js
+- **Vale** (optional): For documentation linting and quality checks
 
 ## ⚙️ Configuration
 
+### Documentation Quality with Vale
+
+We use [Vale](https://vale.sh/) to maintain high-quality documentation standards. Vale checks your writing for clarity, consistency, and adherence to our style guidelines, helping us maintain a coherent tone of voice, accurate terminology, and overall editorial quality across the project.
+
+#### Installing Vale
+
+**macOS:**
+
+```bash
+brew install Vale/tap/vale
+```
+
+**Linux (Snap):**
+
+```bash
+snap install vale
+```
+
+**Windows:**
+
+```bash
+choco install vale
+```
+
+#### Running Vale Locally
+
+```bash
+# Download and install external configuration sources
+vale sync
+
+# Check all documentation files
+vale src/
+
+# Check specific files
+vale src/get-started/helloWorld/1-overview.md
+
+# Get detailed output
+vale --output=line src/
+```
+
+#### Vale Rules
+
+Our Vale configuration uses the Google & Vale writing style guide, which helps ensure:
+
+- Clear and concise language
+- Consistent terminology
+- Professional tone
+- Accessibility best practices
+
 ### Environment Variables (Optional)
 
 Some features of the application require environment variables. This
@@ -138,6 +188,7 @@ Fork this repository and ensure you're working on the `main` branch:
 >   you're satisfied with the preview
 > - All pull requests are reviewed by our team before being merged
 > - Feel free to ask questions in the pull request if you need clarification
+> - **Documentation Quality**: Vale will automatically check your documentation for style and clarity
 
 ### Some conventions