ci: add GitHub community profile, CI tests, Pages, and changelog

mrdavearms · claude · mrdavearms · commit 6be5bb357b8d · 2026-03-20T21:31:46.000+11:00
- Issue templates (bug report + feature request) with YAML forms
- Dependabot config for pip and GitHub Actions dependencies
- Test CI workflow (pytest on push to main/test)
- GitHub Pages landing page in docs/index.html
- CHANGELOG.md generated from all 14 releases
- README: swap download count badge for tests badge

Companion API changes (already live):
- 10 discovery topics added to repo
- Homepage set to GitHub Pages URL
- 3 Discussion posts seeded (welcome, SmartScreen FAQ, Gatekeeper FAQ)
- All 14 release titles standardised to "vX.Y — Description" format

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,71 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill in the details below so we can reproduce and fix it.
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Which operating system are you using?
+      options:
+        - Windows 10
+        - Windows 11
+        - macOS 12 Monterey
+        - macOS 13 Ventura
+        - macOS 14 Sonoma
+        - macOS 15 Sequoia
+        - macOS 16 Tahoe
+        - Linux (running from source)
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: App version
+      description: Found in the About tab (Tab 4), e.g. v2.7.5
+      placeholder: v2.x.x
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the bug clearly. What did you expect to happen vs. what actually happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce the problem?
+      placeholder: |
+        1. Open the app
+        2. Load a PDF template...
+        3. Click...
+        4. Error appears
+    validations:
+      required: true
+
+  - type: textarea
+    id: pdf-info
+    attributes:
+      label: PDF template details (if relevant)
+      description: What kind of PDF form were you using? (e.g. VCAA Evidence Application, a custom form, etc.) Do NOT attach PDFs containing student data.
+    validations:
+      required: false
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots or error messages
+      description: If applicable, paste screenshots or copy the error message text.
+    validations:
+      required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question or help
+    url: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/discussions/categories/q-a
+    about: Ask questions and get help from the community in Discussions
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,48 @@
+name: Feature Request
+description: Suggest an improvement or new feature
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have an idea for making Bulk PDF Generator better? We'd love to hear it.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the situation or workflow that's currently difficult or missing.
+      placeholder: "When I'm processing forms for 300 students, I need to..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: What would you like to happen?
+      description: Describe your ideal solution in plain language.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: role
+    attributes:
+      label: Your role
+      description: Helps us understand your perspective
+      options:
+        - Principal / Assistant Principal
+        - Teacher
+        - School admin / office staff
+        - IT support
+        - TAFE / university staff
+        - Other
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Anything else?
+      description: Additional context, screenshots, or examples.
+    validations:
+      required: false
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "deps"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "ci"
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -0,0 +1,26 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, test]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest
+
+      - name: Run tests
+        run: python -m pytest tests/ -v
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,91 @@
+# Changelog
+
+All notable changes to Bulk PDF Generator are documented here.
+
+## [v2.7.5] — 2026-03-20
+
+- **Fixed: macOS dialog input** — School name, template name, and sheet picker dialogs now accept keyboard input immediately on macOS Tahoe (26).
+- **Faster macOS startup** — Eliminated redundant icon loading (1.3 MB image was opened 3 times, now once). ~24% faster startup.
+- **Polished macOS DMG installer** — The disk image now opens with a professional background, drag-to-Applications arrow, and volume icon.
+- **Ad-hoc code signing** — The macOS app is now signed, reducing Gatekeeper warnings.
+
+## [v2.7.4] — 2026-03-20
+
+- **Polished macOS DMG installer** — Professional background, drag-to-Applications arrow, and volume icon.
+- **Ad-hoc code signing** — macOS app is now signed, reducing Gatekeeper warnings on subsequent versions.
+- **Accurate macOS version metadata** — `CFBundleVersion` is now injected from the git tag at build time instead of being hardcoded.
+- **Updated Gatekeeper instructions** — Release notes now cover both the classic right-click method (macOS 14 and earlier) and the System Settings path (macOS 15+).
+
+## [v2.7.3] — 2026-03-20
+
+- **Fixed: "Check for Updates" failing on Mac** — The update checker now works reliably on macOS. Previously it failed with an SSL certificate error because bundled Mac apps couldn't access the system certificate store.
+
+## [v2.7.2] — 2026-03-19
+
+- **Fixed: "Check for Updates" failing on Mac** — SSL certificate error fix for macOS (superseded by v2.7.3 with further fixes).
+
+## [v2.7.1] — 2026-03-17
+
+- **Fixed: crash on first launch** — Tab 2 (Map Fields) crashed immediately on opening due to a font configuration error. All Windows and macOS users on v2.7 were affected.
+
+## [v2.7] — 2026-03-17
+
+- **Check for Updates** — New button in the About tab lets you check for the latest version without leaving the app.
+- **Fixed: crash on launch** on some school network accounts where the Documents folder is redirected to a network drive. The app now falls back to a local folder automatically.
+
+## [v2.6] — 2026-03-15
+
+- **Automated CI/CD** — Windows `.exe` and macOS `.app` are now built automatically via GitHub Actions. No more manual builds.
+- **Dynamic version badge** — README version badge now auto-updates from the latest release.
+- **Build status badge** — README shows live build status from GitHub Actions.
+
+## [v2.5.6] — 2026-03-10
+
+- About tab and Excel export updated to reference GitHub (migrated from GitLab).
+
+## [v2.5.5] — 2026-03-10
+
+- **Tab 2: Field Mapping Editor** — Tab 2 is now a live mapping editor replacing the previous disabled placeholder. Visual mapping grid, Auto-Map All, Clear All Mappings, live status indicators, persistent mappings saved to template JSON.
+- **Tab 3 warning** — Validation now flags fields that have no mapping and won't auto-match any Excel column, with a prompt to fix them in Tab 2.
+
+## [v2.5.4] — 2026-03-09
+
+- **Security patch** — Upgrades pypdf 6.7.1 to 6.8.0, patching 4 Dependabot security advisories (infinite loop, RAM exhaustion, inefficient decoding).
+
+## [v2.5.3] — 2026-03-09
+
+- Windows release for v2.5 features.
+
+## [v2.5] — 2026-03-09
+
+- **Smart field type detection** — date/dob/birth fields auto-typed as Date.
+- **Field Type Audit dialog** — Review and override field types after PDF analysis.
+- **Date conversion** — Excel serial dates converted to DD/MM/YYYY (Australian format).
+- **Number formatting** — Whole numbers strip trailing `.0`.
+- **Combed field improvements** — Single-field detection, truncation handling.
+
+## [v2.1] — 2026-02-22
+
+- **Multi-sheet Excel support** — Sheet picker dialog for Excel files with multiple sheets.
+- Atomic file writes for crash-safe settings and configs.
+- LRU page cache for PDF preview.
+- Fixed combed-field sequential detection and file-handle leak in preview renderer.
+
+## [v2.0] — 2026-02-22
+
+- Initial release of Bulk PDF Generator as a Windows executable.
+
+[v2.7.5]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7.5
+[v2.7.4]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7.4
+[v2.7.3]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7.3
+[v2.7.2]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7.2
+[v2.7.1]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7.1
+[v2.7]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.7
+[v2.6]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.6
+[v2.5.6]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.5.6
+[v2.5.5]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.5.5
+[v2.5.4]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.5.4
+[v2.5.3]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.5.3
+[v2.5]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.5
+[v2.1]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.1
+[v2.0]: https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases/tag/v2.0
diff --git a/README.md b/README.md
@@ -10,7 +10,7 @@
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS-0078d4?logo=windows&logoColor=white)](https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases)
 [![License](https://img.shields.io/badge/license-MIT-22c55e)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10%2B-3b82f6?logo=python&logoColor=white)](https://python.org)
-[![Downloads](https://img.shields.io/github/downloads/mrdavearms/bulk-pdf-extractor-and-generator/total?style=flat&logo=github&label=downloads&color=22c55e)](https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/releases)
+[![Tests](https://img.shields.io/github/actions/workflow/status/mrdavearms/bulk-pdf-extractor-and-generator/test.yml?logo=github&label=tests)](https://github.com/mrdavearms/bulk-pdf-extractor-and-generator/actions/workflows/test.yml)
 
 </div>
 
diff --git a/docs/index.html b/docs/index.html
