<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**

- [Summary](#summary)
- [Tutorials](#tutorials)
  - [Core Concepts](#core-concepts)
  - [Marketplace Maturity](#marketplace-maturity)
- [How-to Guides](#how-to-guides)
  - [Core Features](#core-features)
  - [Marketplace Maturity](#marketplace-maturity-1)
  - [Workflow Analytics](#workflow-analytics)
- [Reference](#reference)
  - [Core Features](#core-features-1)
  - [Marketplace Maturity](#marketplace-maturity-2)
- [Explanations](#explanations)
  - [Core Architecture](#core-architecture)
  - [Marketplace Maturity](#marketplace-maturity-3)
- [Additional Resources](#additional-resources)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

# Summary

[Introduction](README.md)

# Tutorials

Tutorials are learning-oriented, step-by-step guides that teach you how to accomplish a goal.

## Core Concepts
- [Getting Started](tutorials/getting-started.md)
- [Ontology-to-Code Workflow](tutorials/ontology-to-code.md)
- [AI-Powered Generation](tutorials/ai-powered-generation.md)
- [Marketplace Workflow](tutorials/marketplace-workflow.md)
- [Your First CLI Command](tutorials/05-first-cli-command.md)
- [Creating Custom Code Generation Templates](tutorials/06-template-creation.md)
- [Multi-Language Projects: Synchronized Types](tutorials/07-multi-language-project.md)
- [CI/CD Integration](tutorials/08-ci-cd-integration.md)
- [Testing Generated Code](tutorials/09-testing-generated-code.md)

## Marketplace Maturity
- [Getting Started with Marketplace Maturity](tutorials/getting-started-marketplace-maturity.md)

# How-to Guides

How-to guides are problem-oriented, task-based guides that help you solve specific problems.

## Core Features
- [Installation](how-to-guides/installation.md)
- [Create Templates](how-to-guides/create-templates.md)
- [Use RDF Ontologies](how-to-guides/use-rdf-ontologies.md)
- [Configure Hooks](how-to-guides/configure-hooks.md)
- [Deploy Production](how-to-guides/deploy-production.md)
- [Troubleshoot](how-to-guides/troubleshoot.md)
- [Debug CLI Commands](how-to-guides/debug-cli-commands.md)
- [Migrate Legacy Projects](how-to-guides/migrate-legacy-projects.md)
- [Performance Optimization](how-to-guides/performance-optimization.md)
- [Custom SPARQL Queries](how-to-guides/custom-sparql-queries.md)
- [Error Recovery](how-to-guides/error-recovery.md)

## Marketplace Maturity
- [Assess Package Maturity](how-to-guides/assess-package-maturity.md)
- [Get Package Recommendations](how-to-guides/package-recommendations.md)
- [Compare Packages](how-to-guides/compare-packages.md)
- [Advanced Marketplace Search](how-to-guides/advanced-marketplace-search.md)
- [Set Up Maturity Gates in CI/CD](how-to-guides/maturity-cicd-gates.md)

## Workflow Analytics
- [Track Implementation Workflows](how-to-guides/track-implementation-workflows.md)

# Reference

Reference documentation provides complete, accurate information about ggen's features.

## Core Features
- [CLI Reference](reference/cli.md)
- [Template Reference](reference/templates.md)
- [RDF/SPARQL Reference](reference/rdf-sparql.md)
- [Configuration Reference](reference/configuration.md)
- [API Reference](reference/api-reference.md)
- [File Formats](reference/file-formats.md)
- [Template Variables](reference/template-variables.md)

## Marketplace Maturity
- [Maturity Scoring Specification](reference/maturity-scoring.md)

# Explanations

Explanations provide background information and conceptual understanding.

## Core Architecture
- [Architecture](explanations/architecture.md)
- [Ontology-Driven Development](explanations/ontology-driven.md)
- [Determinism](explanations/determinism.md)
- [Code Projections](explanations/projections.md)
- [Marketplace Ecosystem](explanations/marketplace.md)
- [Why RDF Matters](explanations/why-rdf-matters.md)
- [SPARQL Design Philosophy](explanations/sparql-design-philosophy.md)
- [Type System Design](explanations/type-system-design.md)
- [Performance Characteristics](explanations/performance-characteristics.md)
- [Collaboration Model](explanations/collaboration-model.md)
- [Limitations](explanations/limitations.md)

## Marketplace Maturity
- [Understanding Marketplace Maturity](explanations/marketplace-maturity.md)

# Additional Resources

- [Diataxis Guide](DATAXIS_GUIDE.md)
- [Documentation Tools Survey](DOCUMENTATION_TOOLS_SURVEY.md)
- [Core Team Recommendation](CORE_TEAM_RECOMMENDATION.md)

