# rgen docs
Purpose: project one ontology into many artifacts. Deterministic. Language-agnostic.
## Getting Started
Read in order:
1. [install.md](install.md) - Installation and setup
2. [quickstart.md](quickstart.md) - Quick start with marketplace rpacks
3. [templates.md](templates.md) - Template development guide
4. [marketplace.md](marketplace.md) - Using and publishing rpacks
## Core Concepts
5. [frontmatter.md](frontmatter.md) - Template frontmatter syntax
6. [rdf-shacl-sparql.md](rdf-shacl-sparql.md) - Semantic web integration
7. [projections.md](projections.md) - Code projection patterns
8. [determinism.md](determinism.md) - Reproducible generation
## Advanced Topics
9. [calculus.md](calculus.md) - Mathematical foundations
10. [dx-features.md](dx-features.md) - Developer experience features
11. [rpack-development.md](rpack-development.md) - Creating and publishing rpacks
## Reference
12. [cli.md](cli.md) - Complete CLI reference
13. [troubleshooting.md](troubleshooting.md) - Common issues and solutions
14. [examples/](examples/) - Usage examples and tutorials
## Marketplace Ecosystem
The rgen marketplace provides a curated ecosystem of reusable code generation packs (rpacks):
- **Discover**: Search and browse rpacks by language, framework, or use case
- **Install**: Add rpacks to your project with version management
- **Generate**: Use rpack templates for consistent code generation
- **Publish**: Share your own rpacks with the community
### Key Benefits
- **Quality**: Community-tested templates
- **Consistency**: Standardized patterns across languages
- **Maintenance**: Automatic updates and dependency management
- **Collaboration**: Shared knowledge and best practices
### Workflow
1. **Search** for rpacks matching your needs
2. **Install** rpacks and their dependencies
3. **Generate** code using rpack templates
4. **Customize** with local templates if needed
5. **Publish** your own rpacks to contribute back
## Documentation Structure
- **Getting Started**: Installation and quick start guides
- **Core Concepts**: Templates, RDF, projections, determinism
- **Advanced Topics**: Mathematical foundations, DX features, rpack development
- **Reference**: CLI reference, troubleshooting, examples
- **Marketplace**: Ecosystem overview and workflows
## Contributing
- **Documentation**: Improve guides and examples
- **Rpacks**: Create and publish template collections
- **Examples**: Share usage patterns and best practices
- **Feedback**: Report issues and suggest improvements
## Support
- **Community**: Join discussions and get help
- **Issues**: Report bugs and request features
- **Examples**: Learn from community examples
- **Guides**: Follow step-by-step tutorials