Test Vale CLI prose linter

.vale.ini

@@ -0,0 +1,32 @@
+# Vale Configuration for SignalWire Documentation
+# Enforces sentence case headers instead of title case
+
+# Global settings
+StylesPath = .vale/styles
+MinAlertLevel = warning
+Vocab = Base
+VocabPath = .vale/styles/config/vocabularies
+
+# File patterns to lint - focusing on Markdown files
+[*.md]
+# Base linting rules - only using Vale built-in and our custom styles
+BasedOnStyles = Vale, SentenceCase
+
+# Built-in Vale rules (tuned for technical documentation)
+Vale.Spelling = NO  # Too many false positives with technical terms
+Vale.Repetition = YES
+
+# Enable our custom sentence case rule
+SentenceCase.SentenceCase = error
+
+# Simple MDX support - treat as plain text with limited processing
+[*.mdx]
+BasedOnStyles = SentenceCase
+SentenceCase.SentenceCase = error
+
+# File patterns to ignore
+[*.{yml,yaml,json,js,ts,tsx,jsx}]
+BasedOnStyles = ""
+
+[package*.json]
+BasedOnStyles = "" 

.vale/styles/SentenceCase/SentenceCase.yml

@@ -0,0 +1,102 @@
+extends: capitalization
+message: "Headers should use sentence case. Change '%s' to '%s'."
+level: error
+scope: heading
+
+# Define the capitalization style for headers
+# Only the first word and proper nouns should be capitalized
+match: $sentence
+
+# Exceptions for proper nouns, acronyms, and technical terms that should always be capitalized
+exceptions:
+  - API
+  - SDK
+  - AI
+  - SWML
+  - SignalWire
+  - REST
+  - HTTP
+  - HTTPS  
+  - URL
+  - JSON
+  - YAML
+  - XML
+  - WebSocket
+  - JavaScript
+  - TypeScript
+  - OAuth
+  - JWT
+  - UUID
+  - SQL
+  - NoSQL
+  - CSS
+  - HTML
+  - DOM
+  - CLI
+  - GUI
+  - UI
+  - UX
+  - FAQ
+  - README
+  - CHANGELOG
+  - LICENSE
+  - GitHub
+  - GitLab
+  - npm
+  - Node.js
+  - React
+  - Vue
+  - Angular
+  - Docker
+  - Kubernetes
+  - AWS
+  - GCP
+  - Azure
+  - TCP
+  - UDP
+  - IP
+  - DNS
+  - SSL
+  - TLS
+  - CORS
+  - CSRF
+  - XSS
+  - GDPR
+  - CCPA
+  - SIP
+  - RTP
+  - RTCP
+  - WebRTC
+  - VoIP
+  - SMS
+  - MMS
+  - E164
+  - SIM
+  - PSTN
+  - PBX
+  - IVR
+  - TTS
+  - ASR
+  - NLP
+  - ML
+  - LLM
+  - GPT
+  - BERT
+  - CNN
+  - RNN
+  - LSTM
+  - GRU
+  - PoC
+  - MVP
+  - SaaS
+  - PaaS
+  - IaaS
+  - DevOps
+  - CI/CD
+  - QA
+  - SWAIG
+  - DataMap
+  - Relay
+  - Call
+  - Fabric
+  - Compatibility 

.vale/styles/config/vocabularies/Base/accept.txt

@@ -0,0 +1,161 @@
+SignalWire
+SWML
+SWAIG
+DataMap
+Call Fabric
+Compatibility API
+Relay
+WebRTC
+VoIP
+E164
+SIP
+RTP
+RTCP
+PSTN
+PBX
+IVR
+ASR
+TTS
+SMS
+MMS
+AI
+SDK
+API
+REST
+HTTP
+HTTPS
+JSON
+YAML
+XML
+URL
+WebSocket
+JavaScript
+TypeScript
+OAuth
+JWT
+UUID
+SQL
+NoSQL
+CSS
+HTML
+DOM
+CLI
+GUI
+UI
+UX
+FAQ
+README
+CHANGELOG
+LICENSE
+GitHub
+GitLab
+npm
+Node.js
+React
+Vue
+Angular
+Docker
+Kubernetes
+AWS
+GCP
+Azure
+TCP
+UDP
+IP
+DNS
+SSL
+TLS
+CORS
+CSRF
+XSS
+GDPR
+CCPA
+NLP
+ML
+LLM
+GPT
+BERT
+CNN
+RNN
+LSTM
+GRU
+PoC
+MVP
+SaaS
+PaaS
+IaaS
+DevOps
+CI/CD
+QA
+microservice
+webhook
+endpoint
+middleware
+namespace
+localhost
+frontend
+backend
+fullstack
+config
+env
+localhost
+subfolder
+subdirectory
+filename
+pathname
+hostname
+username
+timestamp
+metadata
+payload
+boolean
+async
+await
+callback
+middleware
+npm
+yarn
+webpack
+babel
+eslint
+prettier
+typescript
+javascript
+nodejs
+reactjs
+vuejs
+angularjs
+dockerfile
+kubernetes
+devops
+github
+gitlab
+bitbucket
+vscode
+webstorm
+intellij
+postman
+insomnia
+swagger
+openapi
+graphql
+grpc
+mongodb
+postgresql
+mysql
+redis
+elasticsearch
+kibana
+grafana
+prometheus
+jenkins
+travis
+circleci
+heroku
+vercel
+netlify
+cloudflare
+aws
+gcp
+azure
+digitalocean 

config/navbar.ts

@@ -17,13 +17,19 @@ const navbar: NavbarItem[] = [
   {
     to: "/platform",
     label: "Platform",
-    position: "left",
+    position: "right",
     type: "dropdown",
     items: [
       {
         label: "Call Fabric",
         to: "/platform/call-fabric",
       },
+      {
+        href: "https://signalwire.com/signin",
+        label: "SignalWire Space",
+        className: "dashboard-navbar-link",
+        "aria-label": "Open SignalWire Space",
+      },
       {
         label: "Dashboard",
         to: "/platform/dashboard",
@@ -42,6 +48,26 @@ const navbar: NavbarItem[] = [
       },
     ],
   },
+  /// SWML Dropdown -------- ///
+  {
+    type: "dropdown",
+    label: "SWML",
+    position: "left", 
+    items: [
+      {
+        label: "SWML Guides",
+        to: "/swml/guides",
+      },
+      {
+        label: "Method Reference",
+        to: "/swml/methods",
+      },
+      {
+        label: "Agents SDK",
+        to: "/agents-sdk",
+      },
+    ],
+  },
 
   /// Products Dropdown -------- ///
   {
@@ -202,14 +228,6 @@ const navbar: NavbarItem[] = [
       },
     ],
   },
-
-  {
-    href: "https://signalwire.com/signin",
-    label: "Dashboard",
-    position: "right",
-    className: "dashboard-navbar-link",
-    "aria-label": "Dashboard",
-  },
   {
     href: 'https://github.com/signalwire/docs',
     position: 'right',

config/sidebarsConfig/agents-sdk-sidebar.ts

@@ -0,0 +1,9 @@
+import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
+
+const agentsSdkSidebar: SidebarsConfig = {
+  agentsSdkSidebar: [
+    { type: "autogenerated", dirName: "swml/agents-sdk" }
+  ],
+};
+
+export default agentsSdkSidebar;

config/sidebarsConfig/index.ts

@@ -22,6 +22,7 @@ import apiSidebar from './rest-api-sidebar';
 import swmlTechRefSidebar from './swml-sidebar';
 import compatibilityAPI from './compatibility-api-sidebar';
 import cantinaSidebar from './cantina-sidebar';
+import agentsSdkSidebar from './agents-sdk-sidebar';
 
 const sidebars: SidebarsConfig = {
   ...homeSidebar,
@@ -32,6 +33,7 @@ const sidebars: SidebarsConfig = {
   ...swmlTechRefSidebar,
   ...compatibilityAPI,
   ...cantinaSidebar,
+  ...agentsSdkSidebar,
 };
 
 export default sidebars;

docs/swml/agents-sdk/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "AI Agents SDK",
+  "position": 6
+}