Skip to main content
Version: v5.6.1

opschain learn

Included from Basic tier

opschain learn [lesson|module|track]

Read the OpsChain learning path embedded in this binary, so the lessons always match the opschain version you are running. The path is lessons of 5–20 minutes grouped into modules by capability (M0 Start here through M14 Packs) and ordered into tracks by role (foundations, author, operator, admin, governance, agent-builder). A bare opschain learn prints the index page — the tracks, then every module with its lessons, durations and verified marks (use -o json|yaml for the lesson index as a document: one row per lesson in path order with lesson, slug, title, module, group, duration, duration_basis, duration_source, requires and verified_by).

A lesson's duration is its reading time plus its doing time. The doing time is measured where a walk of the lesson exists — the runbooks suite's Foundations walk or the OpsChain Academy's exercise timings — and the lesson names that walk (duration_basis: measured, duration_source); every other lesson's doing time is an estimate (duration_basis: estimated, shown as (estimate) in every listing) until a suite or kit measures it. The track totals (opschain learn foundations — about 1h20m) sum the lessons' stated minutes.

One argument addresses what to read:

  • a lesson by id or slug — opschain learn 3.1 and opschain learn 3-1-your-first-change are the same lesson; a lesson kept under its own name has no id prefix in the slug (opschain learn governance-approvals is lesson 10.1);
  • a module by short or full id — opschain learn m3, opschain learn m3-run-work: the module's summary and its lessons with durations and verified marks;
  • a track by id — opschain learn author: the track's lessons in reading order under their modules, with the total duration;
  • a guide by stem — opschain learn core-platform: the how-to guides are listed under Guides in opschain docs but stay readable here.

Every lesson renders the same shape: After this you can (the one outcome), Before you start (the prerequisite lessons as a checklist), In the GUI (where the same thing lives in the browser), the numbered steps with what you should see, Check yourself (the question the OpsChain Academy's exercise asks, where one exists), What you learned and Next. The output is plain text and reads well through a pager (opschain learn 3.1 | less).

Chapter numbers are gone: a chapter number such as 03 or a retired chapter slug answers unknown. There are no aliases — a bookmark on one errors naming the addressing forms.

A lesson carrying an entitlement: packs:<name> front-matter key renders offline with a banner naming the licence requirement (the binary cannot see a licence); a server hides such a lesson from its docs surfaces unless its licence carries the entitlement. A module owned by a pack says so in its overview; its lessons read without the entitlement — only the verified track needs it.

An unknown argument errors naming the addressing forms (exit 1): unknown lesson "<query>" — address a lesson by id (3.1) or slug (3-1-your-first-change), a module (m3) or a track (foundations, author, operator, admin, governance, agent-builder), followed by the reminder that a bare opschain learn lists them.

SubcommandManualPurpose
exportopschain docs cli/learn-exportWrite the learning path to disk for offline reading

See also​

  • opschain docs cli/docs — the reference documentation, same embedding.
  • opschain docs cli/academy — the verified mode of the same path.