This directory contains formal specifications and standards materials for the Design Ontology Language (DOL) project.
- dol-crdt-schema-v1.0.md - The DOL CRDT Schema Specification v1.0
- Formal specification of CRDT annotation syntax
- Semantics for all 7 CRDT strategies
- Type compatibility matrix
- Validation and conformance requirements
- 60+ pages of detailed technical specification
- dol-crdt-implementation-guide.md - Implementation Guide
- For library and tool developers
- Parser implementation guide
- Validator implementation guide
- Code generator patterns
- Runtime library requirements
- Testing and conformance
- dol-crdt-examples/ - Reference Examples
- Complete examples for all 7 CRDT strategies
- Demonstrates best practices
- Includes merge examples and explanations
- See dol-crdt-examples/README.md
- dol-crdt-standards-submission.md - Standards Body Submission Materials
- IETF submission package
- W3C submission package
- ISO/IEC submission package
- Timeline and contacts
The DOL CRDT Schema supports seven core strategies:
| Strategy | Use Case | Example |
|---|---|---|
| immutable | IDs, timestamps | @crdt(immutable) id: Uuid |
| lww | Metadata, settings | @crdt(lww) name: string |
| or_set | Tags, collections | @crdt(or_set) tags: Set<string> |
| pn_counter | Metrics, scores | @crdt(pn_counter) likes: i32 |
| peritext | Rich text | @crdt(peritext) content: string |
| rga | Ordered lists | @crdt(rga) tasks: Vec<TaskId> |
| mv_register | Conflict detection | @crdt(mv_register) theme: Theme |
dol-check schemas/my-schema.doldol-codegen-rust schemas/my-schema.dol -o output/dol-export --format json schemas/my-schema.dolLevel 1 (Basic):
- Supports 4+ strategies (immutable, lww, or_set, pn_counter)
- Type compatibility validation
- JSON schema export
Level 2 (Full):
- All 7 strategies
- Constraint categorization
- Schema evolution
- Passes conformance test suite
Level 3 (Advanced):
- Byzantine fault tolerance
- Cross-library interoperability
- Custom strategy extensions
We welcome contributions to the specification!
- Issues: https://github.com/univrs/dol/issues
- Discussions: https://github.com/univrs/dol/discussions
- Email: [email protected]
- Open an issue describing the problem or suggestion
- Discuss with maintainers and community
- Submit a pull request with proposed changes
- Participate in review process
All specifications in this directory are licensed under:
Creative Commons Attribution 4.0 International (CC BY 4.0)
You are free to:
- Share — copy and redistribute the material
- Adapt — remix, transform, and build upon the material
Under the following terms:
- Attribution — You must give appropriate credit
See https://creativecommons.org/licenses/by/4.0/ for details.
- Initial release of DOL CRDT Schema Specification
- 7 core CRDT strategies
- Complete validation rules
- JSON schema format
- Implementation guide
- Standards submission materials
Univrs Foundation
- Website: https://univrs.org
- Email: [email protected]
- GitHub: https://github.com/univrs/dol
For implementation support:
- Discord: https://discord.gg/univrs
- Forum: https://forum.univrs.org
For standards submission:
- Email: [email protected]