5  Examples

Three Quarto Manuals Shown At Increasing Levels Of Complexity

5.1 What To Expect From These Examples

The starter template shipped by Quarto Manuals is deliberately lean. The examples on this site show what that template looks like once it has been adapted to real work.

Each example mirrors the same Page contract:

• one prerequisite block;
• one or more procedure blocks;
• one check block.

What changes across examples is not the framework, but the complexity of the workflow being narrated.

5.2 The Three Example Levels

5.2.1 Simple

The simple example shows a data-staging workflow. It demonstrates the smallest useful manual:

• a short cover page;
• a helper page for shared context;
• one task page that checks state, performs the operation, and verifies the result.

5.2.2 Intermediate

The intermediate example adapts a real ERA5 data acquisition and aggregation workflow into ordered manual pages. It shows how the same page contract scales when:

• credentials matter;
• large data movement is involved;
• multi-step processing requires several pages;
• each page leaves behind artifacts that later pages can inspect.

5.2.3 Advanced

The advanced example documents a reproducible RSE workbench for shared HPC infrastructure. It shows how Quarto Manuals can support a long, multi-page project assembly process involving containers, package managers, scheduler support, and repeated validation.

5.3 How To Read These Examples

Read the examples as rendered manuals, not just as documentation prose.

They are intended to show what an operator would see after cloning a manual template and opening the pages locally.

That is why the examples are more complete than the root template: the template teaches by prompting, while the examples teach by demonstration.