docs: add Vale report generation instructions and enhance documentation on Oracle protocol

Author: Le-Caignec

.gitignore

@@ -16,3 +16,4 @@ components.d.ts
 #vale
 .github/styles/*
 !.github/styles/config/vocabularies/
+vale-report.txt

.vitepress/sidebar.ts

@@ -110,19 +110,23 @@ export function getSidebar() {
             link: '/get-started/protocol/proof-of-contribution',
           },
           {
-            text: '💸 Pay Per Task Model',
+            text: 'Pay Per Task Model',
             link: '/get-started/protocol/pay-per-task',
           },
           {
-            text: '⚙️ Workers & Workerpools',
+            text: 'Oracle',
+            link: '/get-started/protocol/oracle',
+          },
+          {
+            text: 'Workers & Workerpools',
             collapsed: true,
             items: [
               {
-                text: '🚀 Worker Quick Start',
+                text: 'Worker Quick Start',
                 link: '/get-started/protocol/worker/quick-start',
               },
               {
-                text: '🔒 Manage Workerpool Access',
+                text: 'Manage Workerpool Access',
                 link: '/get-started/protocol/worker/manage-access',
               },
             ],

README.md

@@ -49,6 +49,9 @@ vale src/get-started/helloWorld/1-overview.md
 
 # Get detailed output
 vale --output=line src/
+
+# Generate comprehensive report with statistics
+vale --output=line src/ > vale-report.txt 2>&1
 ```
 
 #### Vale Rules
@@ -61,6 +64,29 @@ ensure:
 - Professional tone
 - Accessibility best practices
 
+#### Vale Statistics and Reports
+
+Generate comprehensive reports to track documentation quality:
+
+**Current Statistics (as of latest run):**
+
+- **Total Issues**: 2,731
+- **Top Issues**:
+  - Headings capitalization (622)
+  - Acronyms explanation (472)
+  - Passive voice (460)
+  - Word choice (294)
+  - Parentheses usage (244)
+
+**Files with Most Issues:**
+
+1. `proof-of-contribution.md` (323 issues)
+2. `glossary.md` (143 issues)
+3. `quick-start-for-developers.md` (75 issues)
+
+**Quality Score**: Based on the number of issues per file, we can calculate a
+quality percentage and track improvements over time.
+
 ### Environment Variables (Optional)
 
 Some features of the application require environment variables. This