---
title: Documentation
description: Learn the modelling concepts, inspect complete examples and look up
  the CMMF 1.3.0-beta.1 format.
editUrl: https://github.com/cmmf-project/cmmf-docs-web/edit/main/src/content/owned/docs/index.md
pagefind: true
---

:::caution[Studio compatibility]
Studio steps are documented for the stable format only. Compatibility with experimental beta semantics is not established. Use the [stable Studio walkthrough](/tools/studio/) and its stable example downloads for visual editing; keep beta projects on the file-based route.
:::


Start with a content need, describe the model, then decide how to implement it in a CMS. These pages explain the format and make its precise rules easy to find.

## New to CMMF?

Read [Start with the content, keep the intent](/versions/1.3.0-beta.1/learn/why-cmmf/), then [create your first model set](/versions/1.3.0-beta.1/docs/get-started/first-model/). The Customer Story tutorial takes you from a content brief to validated files and a Studio import.

Prefer a canvas? [Follow the same model visually](/versions/1.3.0-beta.1/docs/get-started/visual-modelling/). The [example catalogue](/versions/1.3.0-beta.1/examples/) contains complete downloads for Customer Story and the canonical Article set.

## Understand the model

- [Project structure](/versions/1.3.0-beta.1/docs/get-started/project-structure/): manifests and model files.
- [Model kinds](/versions/1.3.0-beta.1/docs/concepts/model-kinds/): entries, components, objects, taxonomies and settings.
- [Relationships](/versions/1.3.0-beta.1/docs/concepts/relationships/): linking, embedding and repeatability.
- [Validation](/versions/1.3.0-beta.1/docs/guides/validation/): structure, semantics and implementation concerns.
- [Translation](/versions/1.3.0-beta.1/docs/concepts/translation/): platform-specific choices and compromises.
- [Visualisation](/versions/1.3.0-beta.1/docs/guides/visualisation/): inspect a model’s relationships.

## Make the modelling decisions

- [Glossary](/versions/1.3.0-beta.1/learn/glossary/): the terms behind the format.
- [Embed or reference?](/versions/1.3.0-beta.1/docs/guides/embed-or-reference/): reuse and lifecycle.
- [Rich text](/versions/1.3.0-beta.1/docs/guides/rich-text/): formatting and embed capabilities.
- [Localisation](/versions/1.3.0-beta.1/docs/guides/localisation/): content variation and implementation policy.
- [Editorial intent](/versions/1.3.0-beta.1/docs/guides/editorial-intent/): help, labels, previews and ownership.
- [Validation errors](/versions/1.3.0-beta.1/docs/guides/errors/): diagnose and repair common failures.
- [Migration to 1.2.0](/versions/1.3.0-beta.1/docs/guides/migrate-to-1-2/): preserve intent while updating notation.

## Find the exact rule

- [Canonical types](/versions/1.3.0-beta.1/docs/reference/canonical-types/).
- [CMMF 1.3.0-beta.1 specification](/spec/1.3.0-beta.1/).
- [Translation contract 1.3.0-beta.1](/spec/1.3.0-beta.1/translation-contract/).
- [Download the 1.3.0-beta.1 model schema](/schemas/1.3.0-beta.1/model.schema.json).
- [Changelog](/changelog/).

## Work with the tools

The [tool overview](/tools/) introduces Studio and the CMMF Skills workflows. Tool capabilities and validation boundaries are described separately from format rules.

Current learning material targets **CMMF 1.3.0-beta.1**. [Historical 1.1.0 specification text](/spec/1.1.0/) is available with an archive notice; the current schema does not establish validation for that version.

## Work with Skills

The six [Skills workflows](/tools/skills/workflows/) share installation and tool documentation across editions. Check [helper compatibility](/tools/skills/sources-and-versions/) before using them: experimental beta semantics are not supported.

## Experimental additions

Start with [adopting the beta](/versions/1.3.0-beta.1/docs/guides/adopt-1-3-beta/), then read [document-level validation hints](/versions/1.3.0-beta.1/docs/guides/document-validation-hints/). Field constraints remain unchanged; the new declarations record conditional and cross-field intent.