Technical Manual

The Technical Manual explains how to maintain the BNR info-hub publication infrastructure.

It covers local setup, static briefing workflows, approved output bundles, Quarto rendering, PDF briefings, release catalogue updates, GitHub Pages deployment, and troubleshooting.

For registry operating procedures, use the BNR Operations Manual.

How-to guides

Practical step-by-step guides for running, updating, rendering, and publishing the BNR information hub.

Suggested and current pages:

• Set up local development
• Start an editing session
• Check Git status before commit
• Run a static briefing
• Add a new static briefing
• Copy an output bundle
• Create a public ZIP bundle
• Render a PDF briefing
• Render the site
• Publish the site

Reference

Stable reference material describing the publication architecture, output contract, naming rules, release catalogue, and deployment pathway.

Suggested and current pages:

• Repository structure
• Compute layer: Stata
• Output contract
• Naming rules
• Quarto publication layer
• PDF briefing route
• GitHub Pages deployment
• Confidential data boundary

Troubleshooting

Guidance for common technical problems encountered when rendering, publishing, checking outputs, or maintaining the repository.

Suggested and current pages:

• Quarto render errors
• PDF render errors
• Missing output files
• Broken download links
• Stata path errors
• Git status cleanup