release: Storybook v0.2.0 - Major syntax and features update
BREAKING CHANGES: - Relationship syntax now requires blocks for all participants - Removed self/other perspective blocks from relationships - Replaced 'guard' keyword with 'if' for behavior tree decorators Language Features: - Add tree-sitter grammar with improved if/condition disambiguation - Add comprehensive tutorial and reference documentation - Add SBIR v0.2.0 binary format specification - Add resource linking system for behaviors and schedules - Add year-long schedule patterns (day, season, recurrence) - Add behavior tree enhancements (named nodes, decorators) Documentation: - Complete tutorial series (9 chapters) with baker family examples - Complete reference documentation for all language features - SBIR v0.2.0 specification with binary format details - Added locations and institutions documentation Examples: - Convert all examples to baker family scenario - Add comprehensive working examples Tooling: - Zed extension with LSP integration - Tree-sitter grammar for syntax highlighting - Build scripts and development tools Version Updates: - Main package: 0.1.0 → 0.2.0 - Tree-sitter grammar: 0.1.0 → 0.2.0 - Zed extension: 0.1.0 → 0.2.0 - Storybook editor: 0.1.0 → 0.2.0
This commit is contained in:
81
docs/_templates/reference-template.md
vendored
Normal file
81
docs/_templates/reference-template.md
vendored
Normal file
@@ -0,0 +1,81 @@
|
||||
# [Concept Name]
|
||||
|
||||
> **Quick Summary**: [One-sentence description of what this is and what it does.]
|
||||
|
||||
## Syntax
|
||||
|
||||
```bnf
|
||||
[Formal grammar or syntax pattern]
|
||||
```
|
||||
|
||||
### Parameters
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
|-----------|------|----------|-------------|
|
||||
| `param1` | Type | Yes | What it does |
|
||||
| `param2` | Type | No | What it does (default: value) |
|
||||
|
||||
## Semantics
|
||||
|
||||
[Precise description of behavior. What happens when this executes? What are the rules? What are the constraints?]
|
||||
|
||||
### Evaluation Order
|
||||
|
||||
[If relevant - describe how/when things are evaluated]
|
||||
|
||||
### Success and Failure
|
||||
|
||||
[If relevant - describe success/failure conditions]
|
||||
|
||||
## Minimal Example
|
||||
|
||||
```storybook
|
||||
[Simplest possible working example]
|
||||
```
|
||||
|
||||
## Complete Example
|
||||
|
||||
```storybook
|
||||
[Realistic example showing all features]
|
||||
```
|
||||
|
||||
## Validation Rules
|
||||
|
||||
- [Rule 1 with explanation]
|
||||
- [Rule 2 with explanation]
|
||||
- [Rule 3 with explanation]
|
||||
|
||||
## Common Errors
|
||||
|
||||
### Error: [Error Message]
|
||||
|
||||
**Cause**: [Why this happens]
|
||||
|
||||
**Solution**: [How to fix it]
|
||||
|
||||
```storybook
|
||||
// ❌ Wrong
|
||||
[bad example]
|
||||
|
||||
// ✅ Correct
|
||||
[good example]
|
||||
```
|
||||
|
||||
## Related Concepts
|
||||
|
||||
- [Related Concept 1](link) - [How they relate]
|
||||
- [Related Concept 2](link) - [How they relate]
|
||||
|
||||
## See Also
|
||||
|
||||
- [Tutorial: Learning Chapter](../tutorial/chapter.md)
|
||||
- [Examples: Use Case](../examples/example.md)
|
||||
- [Reference: Related Feature](other-reference.md)
|
||||
|
||||
## Notes
|
||||
|
||||
[Edge cases, gotchas, performance considerations, design rationale]
|
||||
|
||||
---
|
||||
|
||||
**[Anchor ID for LSP linking]**
|
||||
Reference in New Issue
Block a user