When updating documentation, examples, or config-related code:

1) Follow the source of truth for generated artifacts

• Do change the upstream schema/config file.
• Don’t edit generated files directly.

2) Use the supported frontmatter format for diagram configuration

• Do use frontmatter (e.g., --- block) to set config/theme.
• Don’t rely on deprecated directive init syntax like %%{init: ...}%% in tests/examples.

Example (frontmatter-style):

---
title: Timeline example
theme: forest
config:
  logLevel: debug
---

timeline
  title Timeline Title

3) Prefer storing diagram sources in .mmd (or Markdown) for better developer ergonomics

• Keep an index.ts for metadata, and put each diagram in a corresponding *.mmd file for IDE syntax highlighting/plugins.

4) Avoid brittle Markdown “massaging”

• If you need indentation normalization, use a safe helper like dedent() instead of regex-based whitespace stripping (to prevent breaking lists and indented code blocks).