Start an editing session

BNR info-hub Technical Manual

1 Start an editing session

1.1 Purpose

This guide explains how to begin routine work on the BNR info-hub.

Use it when the repository is already set up on your machine and you want to edit pages, run a briefing, preview the site, or prepare a commit.

1.2 Standard local path

C:\yoshimi-hot\output\analyse-bnr\info-hub

Future users may have a different path. They should record it in their local setup notes.

2 Stage 1: Open the repo

Open VS Code and open:

C:\yoshimi-hot\output\analyse-bnr\info-hub

Open the terminal with:

Ctrl + J

Run:

pwd

If needed, move to the repo root:

cd C:\yoshimi-hot\output\analyse-bnr\info-hub

3 Stage 2: Check current repo state

Run:

git status

Review existing changed or untracked files before starting new work.

Expected changes may include:

site/...
scripts/stata/...
outputs/public/...
site/downloads/files/...
DECISIONS.md
CHANGELOG.md

Unexpected files may include:

site/_site/
site/.quarto/
*.log
*.dta
private data
local path files

4 Stage 3: Start preview if needed

cd C:\yoshimi-hot\output\analyse-bnr\info-hub\site
quarto preview --port 4200

5 Stage 4: End cleanly

Press:

Ctrl + C
cd C:\yoshimi-hot\output\analyse-bnr\info-hub
git status
Back to top