Skip to content

docs: quote YAML frontmatter values with colons #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ANcpLua merged 1 commit into from
Mar 13, 2026
Merged

docs: quote YAML frontmatter values with colons #15

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion datzi/automation/cron-vs-heartbeat.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
id: DATZI-002
category: automation
slug: cron-vs-heartbeat
title: Cron vs Heartbeat: When to Use Each
title: 'Cron vs Heartbeat: When to Use Each'

Check warning on line 5 in datzi/automation/cron-vs-heartbeat.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Cron'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Cron'?", "location": {"path": "datzi/automation/cron-vs-heartbeat.mdx", "range": {"start": {"line": 5, "column": 9}}}, "severity": "INFO"}
summary: Decision guide comparing cron jobs and heartbeats for scheduling, covering use cases, advantages, cost profiles, and how to combine both.
tags: [cron, heartbeat, scheduler, decision-guide, cost, lobster]
---
Expand Down
5 changes: 3 additions & 2 deletions datzi/channels/imessage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,10 @@
id: DATZI-025
category: channels
slug: imessage
title: iMessage (legacy: imsg)
title: 'iMessage (legacy: imsg)'

Check warning on line 5 in datzi/channels/imessage.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'imsg'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'imsg'?", "location": {"path": "datzi/channels/imessage.mdx", "range": {"start": {"line": 5, "column": 27}}}, "severity": "INFO"}

Check warning on line 5 in datzi/channels/imessage.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'iMessage'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'iMessage'?", "location": {"path": "datzi/channels/imessage.mdx", "range": {"start": {"line": 5, "column": 9}}}, "severity": "INFO"}
summary: Legacy iMessage integration via the imsg CLI over JSON-RPC including setup, access control, deployment patterns, and troubleshooting; new setups should use BlueBubbles.
tags: [imessage, imsg, macos, legacy, pairing, groups, attachments, ssh, tailscale]
tags:
[imessage, imsg, macos, legacy, pairing, groups, attachments, ssh, tailscale]
Comment on lines +7 to +8
Copy link

@gemini-code-assist gemini-code-assist bot Mar 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other files and for better readability, it's better to format this long list of tags as a standard YAML block sequence. This is more conventional for multi-line lists.

tags:
  - imessage
  - imsg
  - macos
  - legacy
  - pairing
  - groups
  - attachments
  - ssh
  - tailscale

Comment on lines +7 to +8
---

# iMessage (legacy: imsg)
Expand Down
4 changes: 2 additions & 2 deletions datzi/concepts/agent-loop.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
category: concepts
slug: agent-loop
title: Agent Loop (Datzi)
summary: An agentic loop is the full “real” run of an agent: intake → context assembly → model inference →.
tags: ["concepts", "agent", "loop"]
summary: 'An agentic loop is the full “real” run of an agent: intake → context assembly → model inference →.'

Check warning on line 6 in datzi/concepts/agent-loop.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Microsoft.Terms] Prefer 'personal digital assistant' over 'agent'.

Raw Output:
{"message": "[Microsoft.Terms] Prefer 'personal digital assistant' over 'agent'.", "location": {"path": "datzi/concepts/agent-loop.mdx", "range": {"start": {"line": 6, "column": 56}}}, "severity": "WARNING"}

Check warning on line 6 in datzi/concepts/agent-loop.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[write-good.E-Prime] Try to avoid using 'is'.

Raw Output:
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "datzi/concepts/agent-loop.mdx", "range": {"start": {"line": 6, "column": 27}}}, "severity": "INFO"}

Check warning on line 6 in datzi/concepts/agent-loop.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'agentic'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'agentic'?", "location": {"path": "datzi/concepts/agent-loop.mdx", "range": {"start": {"line": 6, "column": 14}}}, "severity": "INFO"}
tags: ['concepts', 'agent', 'loop']
---

# Agent Loop (Datzi)
Expand Down
2 changes: 1 addition & 1 deletion datzi/concepts/model-failover.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
category: concepts
slug: model-failover
title: Model failover
summary: Datzi handles failures in two stages:.
summary: 'Datzi handles failures in two stages:.'

Check warning on line 6 in datzi/concepts/model-failover.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Datzi'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Datzi'?", "location": {"path": "datzi/concepts/model-failover.mdx", "range": {"start": {"line": 6, "column": 11}}}, "severity": "INFO"}
tags: ['concepts', 'model', 'failover']
---

Expand Down
4 changes: 2 additions & 2 deletions datzi/concepts/multi-agent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
category: concepts
slug: multi-agent
title: Multi-Agent Routing
summary: Goal: multiple *isolated* agents (separate workspace + agentDir + sessions), plus multiple channel accounts (e.g. two.
tags: ["concepts", "multi", "agent"]
summary: 'Goal: multiple *isolated* agents (separate workspace + agentDir + sessions), plus multiple channel accounts (for example two.'

Check warning on line 6 in datzi/concepts/multi-agent.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[write-good.TooWordy] 'multiple' is too wordy.

Raw Output:
{"message": "[write-good.TooWordy] 'multiple' is too wordy.", "location": {"path": "datzi/concepts/multi-agent.mdx", "range": {"start": {"line": 6, "column": 93}}}, "severity": "WARNING"}

Check warning on line 6 in datzi/concepts/multi-agent.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'agentDir'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'agentDir'?", "location": {"path": "datzi/concepts/multi-agent.mdx", "range": {"start": {"line": 6, "column": 66}}}, "severity": "INFO"}

Check warning on line 6 in datzi/concepts/multi-agent.mdx

View workflow job for this annotation

GitHub Actions / Lint documentation 

[vale] reported by reviewdog 🐶
[write-good.TooWordy] 'multiple' is too wordy.

Raw Output:
{"message": "[write-good.TooWordy] 'multiple' is too wordy.", "location": {"path": "datzi/concepts/multi-agent.mdx", "range": {"start": {"line": 6, "column": 17}}}, "severity": "WARNING"}
tags: ['concepts', 'multi', 'agent']
---

# Multi-Agent Routing
Expand Down
2 changes: 1 addition & 1 deletion datzi/concepts/session.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: DATZI-094
category: concepts
slug: session
title: Session Management
summary: Datzi treats **one direct-chat session per agent** as primary. Direct chats collapse to agent:<agentId>:<mainKey> (.
summary: 'Datzi treats **one direct-chat session per agent** as primary. Direct chats collapse to agent:<agentId>:<mainKey> (.'
tags: ['concepts', 'session']
---

Expand Down
Loading