Bryan Helmkamp
4605f821e8
Add custom TextMate grammar for DOT syntax highlighting in docs
...
Revert the graphviz language identifier back to dot (Shiki doesn't
bundle either) and register a custom TextMate grammar via Mintlify's
styling.codeblocks.languages.custom config. The grammar (extracted from
apps/arc-web/app/data/dot-grammar.ts) highlights keywords, shape names,
attributes, strings, comments, and operators.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 21:41:54 -05:00
Bryan Helmkamp
6a98dcc246
Use graphviz language identifier for DOT code blocks, add titles to workflow examples
...
Changes ```dot to ```graphviz across all docs for better syntax highlighting
in Mintlify (Shiki). Full digraph blocks get a title derived from the workflow
name (e.g. title="hello.dot").
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 21:26:45 -05:00
Bryan Helmkamp
7505cb4ce1
Fill in Agents, Human-in-the-Loop, Stylesheets, Variables pages
...
- Agents: agent loop, built-in tools, prompts, sub-agents, skills, hooks
- Human-in-the-Loop: gates, accelerators, freeform input, auto-approve
- Stylesheets: selectors, specificity, properties, cascading, full examples
- Variables: run config vars, $goal expansion, variable merging
- Remove model stylesheets section from core workflows page (now dedicated page)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 17:42:19 -05:00
Bryan Helmkamp
dd797cca1a
Fill in core docs: How Arc Works, Models, Workflows, Nodes & Stages, Transitions
...
- How Arc Works: end-to-end architecture with diagram, execution loop, retries,
sandboxes, observability, and resume
- Models: multi-provider rationale, full catalog table, stylesheets, overrides
via CLI and TOML, ensemble SVG
- Workflows: anatomy SVG, key node types, branching/loops SVG, parallel SVG,
model stylesheets, goal gates
- Nodes & Stages: all node types with attributes, fidelity/thread_id tables,
join/error/retry policy tables
- Transitions: edge selection priority, condition expression language, agent
transitions, human gates, weight tiebreaking
- Remove workflows/ingestion page
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 17:29:57 -05:00
Bryan Helmkamp
d450695a20
Scaffold Mintlify docs site with full navigation structure
...
Replace boilerplate Mintlify starter with Arc docs outline:
- Switch to almond theme (sidebar search, card-based layout)
- Top nav: Documentation, Guides, API Reference, Changelog
- Documentation sidebar: Getting Started, Core Concepts, Defining
Workflows, Executing Workflows, Agents, Administration, Deployment,
Reference
- Guides tab with example workflows
- Get Started button in navbar
- 48 MDX stub pages across 9 directories
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-03 10:33:09 -05:00
