Skip to content

Add issue forms and PR template - #38

Open
dwelch2344 wants to merge 1 commit into
CVEProject:mainfrom
dwelch2344:main
Open

Add issue forms and PR template#38
dwelch2344 wants to merge 1 commit into
CVEProject:mainfrom
dwelch2344:main

Conversation

@dwelch2344

Copy link
Copy Markdown

Took a pass at #21 (issue and PR templates). Three files, all under .github/:

  • ISSUE_TEMPLATE/bug_report.yml
  • ISSUE_TEMPLATE/feature_request.yml
  • PULL_REQUEST_TEMPLATE.md

A few notes on the choices:

  • YAML issue forms instead of legacy Markdown. cve-services and cve-core both
    use the old .md style, but forms let us mark the record and the Diagnostics
    output as render: json, so they come in fenced and readable instead of
    depending on the filer to do it. Library version and Node version are required
    fields for the same reason. The cve-services templates also carry leftover
    (TBD) placeholders and ask for a Postman file, which doesn't mean anything for
    a library, so copying them wasn't worth it.

  • One bug form, not two. "This record validates incorrectly" and "the library
    crashed" want the same fields, so there's a dropdown at the top instead of a
    second template. It also makes false-positive vs false-negative explicit at
    triage.

  • PR checklist only covers typecheck, build, and test:local, since those
    are the only scripts that exist today. Nothing about lint or CI until Add continuous integration workflow #26 lands.

  • "Validation impact" is the one non-obvious PR section. Changing what the
    library accepts or rejects changes what CNAs can publish, so an explicit "None"
    beats leaving it implied.

  • Deliberately skipped: config.yml routing, a user story template (very
    cve-services shaped), and CONTRIBUTING/SECURITY/CODE_OF_CONDUCT. Blank issues
    stay enabled — at ~19 open issues we don't need the funnel yet.

    • The two scope checkboxes on the feature form are a cheap stand-in for contact links: they nudge
      schema-level and policy-level requests elsewhere without any routing config.

One open question: cve-services and cve-core both keep PULL_REQUEST_TEMPLATE.md
at the repo root. I put ours in .github/ since this repo had no .github/ at
all. Happy to move it if we'd rather match, though standardizing across the org
is probably a .github default-repo conversation worth having.


Will put screenshots in comments in a sec...

Two YAML issue forms (bug report, feature request) and a PR template
under .github/. Forms use render: json for the record and Diagnostics
output so reproductions come in fenced. PR checklist covers only the
npm scripts that exist today: typecheck, build, test:local.

Refs CVEProject#21

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@dwelch2344

dwelch2344 commented Sep 1, 2026

Copy link
Copy Markdown
Author
image New Issue
image Bug Report
image Feature Request
image PR raw image PR preview

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