Simplify docs language and rename reference to Syntax

Author: seblavoie

.vitepress/config.ts

@@ -25,7 +25,7 @@ export default defineConfig({
         ]
       },
       {
-        text: 'YAML Reference',
+        text: 'Syntax',
         items: [
           { text: 'Overview', link: '/reference/' },
           { text: 'Folders', link: '/reference/folders' },

examples/index.md

@@ -1,6 +1,6 @@
 # Examples
 
-Ready-to-use YAML recipes for common motion graphics patterns.
+Ready-to-use syntax recipes for common motion graphics patterns.
 
 ## Available examples
 
@@ -18,7 +18,7 @@ Creating .mogrt-ready templates with Essential Graphics.
 
 ## How to use
 
-1. Copy the YAML from any example
+1. Copy the example text from any recipe
 2. Paste it into the Compdown panel
 3. Click **Create**
 4. Modify as needed

examples/motion-templates.md

@@ -9,7 +9,7 @@ Motion Graphics Templates are After Effects compositions with exposed properties
 Compdown lets you:
 1. Define compositions with editable properties
 2. Expose those properties via Essential Graphics
-3. Export back to YAML preserving the property mappings
+3. Export back to Compdown text preserving the property mappings
 
 ## Basic template
 
@@ -286,9 +286,9 @@ essentialGraphics:
 ```
 
 ### Test round-trip
-1. Create the template from YAML
+1. Create the template from Compdown text
 2. Modify values in AE
-3. Export back to YAML
+3. Export back to text
 4. Verify the properties are preserved
 
 ## Exporting as .mogrt

guide/index.md

@@ -1,10 +1,10 @@
 # Introduction
 
-Compdown is an After Effects extension that lets you describe compositions, layers, and animations in YAML — then create them with a single click.
+Compdown is an After Effects extension that lets you describe compositions, layers, and animations in text — then create them with a single click.
 
 ## What is Compdown?
 
-Instead of clicking through menus or writing ExtendScript, you write human-readable YAML:
+Instead of clicking through menus or writing ExtendScript, you write readable Compdown syntax:
 
 ```yaml
 compositions:
@@ -25,13 +25,13 @@ Click a button, and Compdown creates the composition with all layers, properties
 ## Why text-based workflows?
 
 ### Readable
-YAML is designed for humans. You can read a Compdown file and understand what it creates without running it.
+Compdown syntax is designed to be human-friendly. You can read a file and understand what it creates without running it.
 
 ### Shareable
 A Compdown file is just text. Email it, paste it in Slack, commit it to git, or share it in a gist. No binary files, no version compatibility issues.
 
 ### Fast
-Building variations? Copy the YAML, change a few values, paste it back. No need to duplicate comps or dig through the project panel.
+Building variations? Copy the text, change a few values, paste it back. No need to duplicate comps or dig through the project panel.
 
 ### AI-friendly
 Text in, text out. AI tools can read, modify, and generate Compdown files just like any other code. This opens up workflows where AI helps draft scenes, explore variations, or build first passes.
@@ -49,7 +49,7 @@ Text in, text out. AI tools can read, modify, and generate Compdown files just l
 
 ## Two-way workflow
 
-Compdown isn't just for creation. You can also **export existing compositions** back to YAML. This enables:
+Compdown isn't just for creation. You can also **export existing compositions** back to text syntax. This enables:
 
 - Documenting what a comp contains
 - Version controlling motion design

guide/installation.md

@@ -50,7 +50,7 @@ This starts a dev server at `localhost:3000`. Changes to the panel code will hot
 
 1. Open After Effects
 2. Go to **Window > Extensions > Compdown**
-3. You should see the Compdown panel with a YAML editor
+3. You should see the Compdown panel with a text editor
 
 If the panel doesn't appear, check:
 - Debug mode is enabled (for local builds)

guide/quick-start.md

@@ -1,10 +1,10 @@
 # Quick Start
 
-Let's create your first composition with Compdown. By the end of this guide, you'll understand the basic YAML structure and how to build animated layers.
+Let's create your first composition with Compdown. By the end of this guide, you'll understand the basic structure and how to build animated layers.
 
 ## Your first composition
 
-Open the Compdown panel in After Effects and paste this YAML:
+Open the Compdown panel in After Effects and paste this:
 
 ```yaml
 compositions:
@@ -27,7 +27,7 @@ Click the **Create** button. Compdown will:
 2. Add a text layer with "Hello World" centered in the frame
 3. Add a dark solid layer called "background" behind it
 
-That's it. You've created your first composition from YAML.
+That's it. You've created your first composition from text syntax.
 
 ## Understanding the structure
 
@@ -153,7 +153,7 @@ Compdown works both ways. To export an existing composition:
 
 1. Select a composition in After Effects
 2. Click the **Export** button in Compdown
-3. The YAML representation appears in the editor
+3. The composition appears as text syntax in the editor
 
 This is useful for:
 - Understanding what properties a comp has
@@ -164,5 +164,5 @@ This is useful for:
 
 You now know the basics. Explore further:
 
-- [Reference](/reference/) — Complete YAML schema documentation
+- [Reference](/reference/) — Complete syntax documentation
 - [Examples](/examples/) — Real-world recipes and patterns

index.md

@@ -4,7 +4,7 @@ layout: home
 hero:
   name: Compdown
   text: A natural language for After Effects
-  tagline: Describe compositions in YAML, create them with a click
+  tagline: Describe compositions in plain text, create them with a click
   actions:
     - theme: brand
       text: Get Started

reference/compositions.md

@@ -68,7 +68,7 @@ compositions:
 See [Layers](/reference/layers) for complete layer documentation.
 
 ::: tip Layer stack order
-Layer order in YAML maps to the AE stack with the first layer on top. Put background layers later in the list so they render behind foreground layers.
+Layer order in Compdown syntax maps to the AE stack with the first layer on top. Put background layers later in the list so they render behind foreground layers.
 :::
 
 ## Composition nesting

reference/effects.md

@@ -40,7 +40,7 @@ effects:
 The `matchName` is AE's internal identifier that stays consistent regardless of UI language.
 
 ::: tip Finding matchNames
-You can find effect matchNames in the [After Effects Scripting Guide](https://ae-scripting.docsforadobe.dev/) or by examining exported YAML from Compdown.
+You can find effect matchNames in the [After Effects Scripting Guide](https://ae-scripting.docsforadobe.dev/) or by examining exported Compdown text.
 :::
 
 ## Property value types

reference/essential-graphics.md

@@ -99,11 +99,11 @@ By default, Compdown encodes the property path in the controller name:
 Display Name [path:layer.transform.position]
 ```
 
-This allows exported YAML to include the full property path, enabling workflows like:
+This allows exported text to include the full property path, enabling workflows like:
 
-1. Create comp from YAML with Essential Graphics
+1. Create comp from Compdown text with Essential Graphics
 2. Modify in Premiere
-3. Export back to YAML with paths preserved
+3. Export back to text with paths preserved
 
 ### Disabling path encoding