Template

Concept Template

How to contribute a concept page to the Guardian docs

Concept Template

Use for: feature overviews, explanations of platform constructs, background on how something works. A concept page should never contain steps — those belong in a task page. The concept page is typically the parent container in GitBook, with task pages as children beneath it.

Concept Page Title: Name the thing, not the action — e.g. "Policy Integrity Tests", "TrustChain", "Verifiable Credentials"

One to two sentences. Plain language definition of what this is.

The problem it solves

What would happen without this feature or capability. Why it exists.

How it works

The mental model. How to think about this conceptually. Not steps — those belong in the task page.

Key distinctions

How this differs from something it might be confused with. Remove this section if there is nothing to distinguish.

  • Task: how to use this

  • Reference: full specification

  • Concept: related concept

Last updated

Was this helpful?