Skip to content

docs: align model series documentation with snapd#378

Open
ndyer wants to merge 1 commit into
canonical:mainfrom
ndyer:docs/model-series-current-practice
Open

docs: align model series documentation with snapd#378
ndyer wants to merge 1 commit into
canonical:mainfrom
ndyer:docs/model-series-current-practice

Conversation

@ndyer

@ndyer ndyer commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Summary

  • clarify that the model assertion series is part of the assertion index to allow assertion formats to vary by series
  • remove the unimplemented rolling series wording
  • document that snapd currently accepts model series 16 because compatibility has not needed to be broken

Testing

  • not run; documentation-only change

@ndyer ndyer force-pushed the docs/model-series-current-practice branch from 4688e1e to ccac12a Compare June 30, 2026 14:01
@ndyer ndyer requested review from pedronis and zyga June 30, 2026 14:01

@pedronis pedronis left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

couple suggestions

The index for this assertion is the tuple \<`series`, `brand-id`, `model`\> and the fields are typically used in the following order:

- `series` allows the brand to define which release of the platform the device uses. “rolling” is the name of the development series that bridges stable series, which have names like “16” or “18”.
- `series` indicates which release series of the platform the device uses. It is included in the assertion index to allow assertion formats to vary from series to series. This lets a snap-based system to have a clear expectation of that assertion's structure and content.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/index/headers/

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... to allow snap related assertion formats and the namespace of snap ids ...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants