Clarify website onboarding and fork staging previews

LU
6h ago
+33-25

Make the website contribution guide usable for first-time contributors: add browser-only content edits, correct fork/sync/push commands, pin Hugo Extended 0.158.0 to the workflows, and explain generated content and fork staging previews. Clarify the existing repository and contribution licences and link FORRT's Code of Conduct.

Validation: checked commands and staging behaviour against current deploy workflows; checked local link targets and the canonical conduct URL; git diff --check passed. Opus 5.5 reviewed the guide, its findings were applied, and a final review approved it. Documentation only; no site build or deployment was run.

Summary by cubic

Opens the website contribution guide to browser-only edits and aligns the fork workflow with how staging actually deploys.

  • Corrects fork, sync, and push commands for both git and RStudio setups to use the contributor's own fork plus an upstream remote.
  • Pins Hugo Extended to 0.158.0 to match production and staging.
  • Explains which content is generated during deployment and must be changed via source forms, naming files like data/publications.yaml and the generated static/data/fred_citation.txt.
  • Details the maintainer-run single_pr preview for external forks and the monthly report's skipped-PR list.
  • Separates the repository licence (CC BY-NC-SA 4.0) from the contribution policy (CC BY 4.0) and links the Code of Conduct.