Skip to content

docs: convert issue templates to YAML forms, add PR template - #42

Open
petercorke wants to merge 1 commit into
mainfrom
docs/issue-pr-templates
Open

docs: convert issue templates to YAML forms, add PR template#42
petercorke wants to merge 1 commit into
mainfrom
docs/issue-pr-templates

Conversation

@petercorke

Copy link
Copy Markdown
Owner

Summary

  • Converts the two existing Markdown issue templates to GitHub's YAML form syntax (matching MVTB's convention) — same content/fields, structured form UI instead of free-form Markdown:
    • 0repository-bug-report.yml — repo-specific bugs, still redirects toolbox-specific reports to RTB/MVTB/SMTB/bdsim/Swift/SG/pgraph's own trackers
    • 1errata.yml — book errata (page number, location, description)
  • Adds pull_request_template.md, scoped to what's actually true in this repo (no CI/bots) — asks that pytest tests/ passes locally and that new code follows the repo's type-hint/docstring conventions.

Deliberately left out of scope (discussed, not wanted): moving the toolbox-routing list into config.yml contact_links, disabling blank issues, and a feature-request template.

Test plan

  • Both YAML templates parse cleanly and have the expected number of form fields (validated with yaml.safe_load)

Replaces the two old Markdown issue templates with GitHub's structured
YAML form syntax (matching the convention already used in MVTB), same
content and fields, just the nicer form UI:
- 0repository-bug-report.yml: repo-specific bugs, still redirects
  toolbox-specific reports to RTB/MVTB/SMTB/bdsim/Swift/SG/pgraph's
  own issue trackers
- 1errata.yml: book errata (page number, location, description)

Adds a pull_request_template.md scoped to what's actually true here --
no CI/bots exist in this repo, so unlike MVTB's template this one just
asks that `pytest tests/` passes locally and that new code follows the
type-hint/docstring conventions.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant