vikram-dagger
diff --git a/‎docs/.dagger/main.go‎
Lines changed: 4 additions & 5 deletions b/‎docs/.dagger/main.go‎
Lines changed: 4 additions & 5 deletions
diff --git a/‎docs/.markdownlintignore‎
Lines changed: 3 additions & 0 deletions b/‎docs/.markdownlintignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎docs/STYLE_GUIDE.md‎
Lines changed: 8 additions & 2 deletions b/‎docs/STYLE_GUIDE.md‎
Lines changed: 8 additions & 2 deletions
@@ -38,7 +38,7 @@ type Docs struct {
 
 const (
 	generatedSchemaPath           = "docs/docs-graphql/schema.graphqls"
-	generatedCliZenPath           = "docs/current_docs/reference/cli.mdx"
+	generatedCliZenPath           = "docs/current_docs/reference/cli/index.mdx"
 	generatedAPIReferencePath     = "docs/static/api/reference/index.html"
 	generatedDaggerJSONSchemaPath = "docs/static/reference/dagger.schema.json"
 	generatedEngineJSONSchemaPath = "docs/static/reference/engine.schema.json"
@@ -52,12 +52,10 @@ const (
 )
 
 const cliZenFrontmatter = `---
-slug: /reference/cli/
-pagination_next: null
-pagination_prev: null
+title: "CLI Reference"
+description: "Learn how to use the Dagger CLI to run composable workflows in containers."
 ---
 
-# CLI Reference
 `
 
 // Build the docs website
@@ -98,6 +96,7 @@ func (d Docs) Lint(ctx context.Context) (rerr error) {
 			From("tmknom/markdownlint:"+markdownlintVersion).
 			WithMountedDirectory("/src", d.Source).
 			WithMountedFile("/src/.markdownlint.yaml", d.Source.File(".markdownlint.yaml")).
+			WithMountedFile("/src/.markdownlintignore", d.Source.File("docs/.markdownlintignore")).
 			WithWorkdir("/src").
 			WithExec([]string{
 				"markdownlint",
 
@@ -0,0 +1,3 @@
+docs/archived_docs/*
+docs/current_docs/reference/typescript/*
+docs/node_modules/*
@@ -33,7 +33,7 @@
   </Tabs>
   ```
 
-- Always capitalize Dagger core types such as `Container`, `Secret`, etc
+- Always capitalize and use code font for Dagger core types such as `Container`, `Secret`, etc
 - Omit the `()` for readability since a lot of the time it's either not necessary, or implies no args are needed, and sometimes you just want to refer to a method call and ignore its required args e.g. `Container.asService`
 - Dagger Functions and arguments in code listings should be documented inline "wherever possible", except for Cookbook recipes where this is "mandatory" since these are intended to be best-practice examples. This inline documentation includes at minimum
   - a one-line comment for the function
@@ -59,7 +59,13 @@
 
 - When writing lists, use a hyphen `-` for unordered lists and a number followed by a period `1.` for ordered lists
 - Lists should not end with a period
-- Keywords, features, concepts in the lists should be bolded followed by `:` (e.g. `**State and duration**: Get visual cues for cached and pending states, and see exactly how long each step of your workflow takes (including accounting for lazy effects installed by a Dagger Function).`)
+- List lead-ins or labels followed by a colon (`:`) should be in bold text e.g. `**State and duration**: Get visual cues for cached and pending states, and see exactly how long each step of your workflow takes.`
+
+## Formatting styles
+
+- Body text should not use bold, italic or other formatting styles except in the following cases:
+  - List lead-ins or labels should use bold text (see `Lists` section)
+  - User interface labels should use bold text e.g. `Click the **Start** button.`
 
 ## Cookbook
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+docs/archived_docs/*`
	`2`	`+docs/current_docs/reference/typescript/*`
	`3`	`+docs/node_modules/*`