From 1d014c54ef30a64e31657ffee9a991c5b62abb7a Mon Sep 17 00:00:00 2001 From: Twest2 Date: Sat, 31 Oct 2026 01:09:37 -0500 Subject: [PATCH 1/3] Update the issue and pull request templates - Bug reports ask how StepForge was installed with a checklist that includes the Microsoft Store, the Launchpad PPA and every other channel, and whether the problem survives Check for updates. - The issue chooser links the security policy and the getting-started guides (ISSUE_TEMPLATE/config.yml). - The legacy .github/ISSUE_TEMPLATE.md, a copy of the Improvement template, is removed. - The pull request template's areas cover sharing, cloud sync beyond Google Drive, AI agents, branding, translations and the release channels, and its checklist matches the review checklist in docs/CONTRIBUTING.md (tests, translations, manual checks). --- .github/ISSUE_TEMPLATE.md | 29 ---------------------------- .github/ISSUE_TEMPLATE/bug_report.md | 12 +++++++++++- .github/ISSUE_TEMPLATE/config.yml | 8 ++++++++ .github/PULL_REQUEST_TEMPLATE.md | 23 +++++++++++++++------- 4 files changed, 35 insertions(+), 37 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE.md create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md deleted file mode 100644 index d8683ad1..00000000 --- a/.github/ISSUE_TEMPLATE.md +++ /dev/null @@ -1,29 +0,0 @@ -## Type - -- [ ] Improvement -- [ ] Bug -- [ ] Documentation -- [ ] Tests -- [ ] Git / workflow -- [ ] Other - -## Summary - - - -## Current behavior - -## Desired behavior - -## Acceptance criteria - -- [ ] -- [ ] - -## Testing notes - - - -## Extra context - - diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 145ac684..17a3fd9b 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -28,13 +28,23 @@ assignees: Twest2 ## Your setup - **StepForge version** (Settings → About): + - [ ] It still happens after **Settings → About → Check for updates** - **Operating system:** - [ ] Windows 10 - [ ] Windows 11 - [ ] Ubuntu 26.04 - [ ] Fedora 44 - [ ] Other: -- **Installed with:** +- **Installed with:** + - [ ] Microsoft Store + - [ ] Chocolatey + - [ ] Setup `.exe` from GitHub Releases + - [ ] APT repository + - [ ] Launchpad PPA + - [ ] DNF repository + - [ ] `.deb` or `.rpm` from GitHub Releases + - [ ] Portable `.tar.gz` + - [ ] From source - **Linux only, desktop session:** ## Anything else? diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..89dfba05 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: true +contact_links: + - name: Report a security problem + url: https://github.com/Twest2/StepForge/blob/main/docs/SECURITY.md + about: Please email git@twestbrook.com instead of opening a public issue. + - name: Install and getting started guides + url: https://github.com/Twest2/StepForge/blob/main/docs/GETTING_STARTED.md + about: Installing StepForge, recording your first guide, and fixes for common problems. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index fb8d8ca3..cc766040 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -14,13 +14,17 @@ Closes # ## Area -- [ ] Guide editor - [ ] Capture / recording +- [ ] Guide editor - [ ] Library - [ ] Settings - [ ] Exports -- [ ] Google Drive sync -- [ ] Packaging / install +- [ ] Sharing and publishing (GitHub Pages, Confluence, Wiki.js) +- [ ] Cloud sync (Google Drive, OneDrive, Dropbox, Nextcloud / WebDAV) +- [ ] AI and AI agents (MCP) +- [ ] Branding +- [ ] Translations +- [ ] Packaging, install, or release (Microsoft Store, Chocolatey, APT, DNF) - [ ] Documentation - [ ] Tests - [ ] Git / workflow @@ -30,7 +34,7 @@ Closes # - [ ] `bash tests/run_test.sh` passes - [ ] Tested manually (describe below) - + ## Screenshots or recordings @@ -38,12 +42,17 @@ Closes # ## Rollout notes - + ## Checklist + + - [ ] Linked to an issue above - [ ] Scope is limited to that issue -- [ ] Docs updated for user-visible changes -- [ ] No new network calls, runtime dependencies, or third-party branding +- [ ] New behavior has tests that check real output +- [ ] Docs updated for anything users will notice +- [ ] New interface text is in `t()`, and `npm run translations` lists nothing missing +- [ ] Anything that still needs manual verification is listed above +- [ ] No new network calls, dependencies, or third-party branding - [ ] Follow-up work is tracked in an issue From e82d519eda3733f787236cbec9f02595ef8fa41b Mon Sep 17 00:00:00 2001 From: Tyler Westbrook Date: Sat, 31 Oct 2026 01:14:20 -0500 Subject: [PATCH 2/3] Remove 'Feature' label from bug report template --- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 17a3fd9b..6087e6d5 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -2,7 +2,7 @@ name: Bug report about: Something in StepForge isn't working as expected title: "[BUG] " -labels: Feature, Potential bug +labels: Potential bug assignees: Twest2 --- From a699a72f29dccfcdf79d22c1b74333447d2e54df Mon Sep 17 00:00:00 2001 From: Tyler Westbrook Date: Sat, 31 Oct 2026 01:15:31 -0500 Subject: [PATCH 3/3] Revise bug report template for better clarity Updated wording for clarity in bug report template. --- .github/ISSUE_TEMPLATE/bug_report.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 6087e6d5..81f32897 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -28,7 +28,7 @@ assignees: Twest2 ## Your setup - **StepForge version** (Settings → About): - - [ ] It still happens after **Settings → About → Check for updates** + - [ ] It happens on the current version of StepForge (**Settings → About → Check for updates**) - **Operating system:** - [ ] Windows 10 - [ ] Windows 11 @@ -40,7 +40,6 @@ assignees: Twest2 - [ ] Chocolatey - [ ] Setup `.exe` from GitHub Releases - [ ] APT repository - - [ ] Launchpad PPA - [ ] DNF repository - [ ] `.deb` or `.rpm` from GitHub Releases - [ ] Portable `.tar.gz`