Skip to content

CLAUDE.md

Latest commit

 

History

History
34 lines (23 loc) · 1.07 KB

CLAUDE.md

File metadata and controls

34 lines (23 loc) · 1.07 KB

CLAUDE.md

Purpose

Carpentries Workbench lesson site for Research Software Documentation, part of the FAIR² course at the University of Sheffield. Published at https://fair2-for-research-software.github.io/Documentation/.

Repository layout

  • config.yaml — lesson metadata and episode order
  • episodes/ — primary content files (order defined in config.yaml)
  • learners/, instructors/, profiles/ — supplementary pages
  • links.md — shared link definitions used across episodes
  • site/ — auto-generated; do not edit

Linting

pre-commit run --all-files          # all checks
pre-commit run markdownlint-cli2 --all-files
pre-commit run codespell --all-files

Markdownlint runs with fix: true — it auto-corrects on pre-commit.

Carpentries callout syntax

Episodes use fenced div callouts — see any existing episode for examples. Types: keypoints, objectives, challenge, solution, callout, prereq, discussion.

CI/CD

Workflow files in .github/workflows/ are managed by update-workflows.yaml — do not edit manually.