diff --git a/website/.vitepress/config.ts b/website/.vitepress/config.ts
index 3a64a470..a1f7905c 100644
--- a/website/.vitepress/config.ts
+++ b/website/.vitepress/config.ts
@@ -116,7 +116,7 @@ export default defineConfig({
             ],
           },
           { text: 'Project Config', link: '/reference/sgconfig.html' },
-          { text: 'Rule Config', link: '/reference/yaml.html', collapsed: true,
+          { text: 'Rule Config', link: '/reference/yaml.html', collapsed: false,
             items: [
               { text: 'fix', link: '/reference/yaml/fix.html' },
               { text: 'transformation', link: '/reference/yaml/transformation.html' },
@@ -134,7 +134,7 @@ export default defineConfig({
         text: 'Advanced Topics',
         items: [
           { text: 'Frequently Asked Questions', link: '/advanced/faq.html'},
-          { text: 'How ast-grep Works', link: '/advanced/how-ast-grep-works.html',
+          { text: 'How ast-grep Works', link: '/advanced/how-ast-grep-works.html', collapsed: false,
             items: [
               { text: 'Core Concepts', link: '/advanced/core-concepts.html'},
               { text: 'Pattern Syntax', link: '/advanced/pattern-parse.html'},
diff --git a/website/reference/yaml.md b/website/reference/yaml.md
index 6ef958b3..c69ac1a9 100644
--- a/website/reference/yaml.md
+++ b/website/reference/yaml.md
@@ -10,6 +10,8 @@ One YAML file can contain multiple rules, separated by `---`.
 
 An ast-grep rule is a YAML object with the following keys:
 
+[[toc]]
+
 ## Basic Information
 
 ### `id`