Updating docs

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,103 @@
+name: Bug report
+description: Report a problem with Browser Switch behavior
+title: "Bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug.
+
+        Please include enough detail to reproduce the issue on macOS 14+ and describe what you expected to happen.
+
+  - type: input
+    id: app_version
+    attributes:
+      label: Browser Switch version
+      description: Use the About panel version/build if available.
+      placeholder: "e.g. 1.2.3 (Build abc1234)"
+    validations:
+      required: true
+
+  - type: input
+    id: macos_version
+    attributes:
+      label: macOS version
+      description: Browser Switch targets macOS 14+.
+      placeholder: "e.g. macOS 14.7.2 (Sonoma)"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: How did you install or run Browser Switch?
+      options:
+        - GitHub Releases app build
+        - scripts/install.sh
+        - Local source build (swift run)
+        - Local built app (scripts/build-app.sh)
+        - Xcode run
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Which area is affected?
+      options:
+        - Browser switching
+        - Menu bar UI / menu behavior
+        - Network / VPN context
+        - Power tools (Option key features)
+        - Run on Startup / settings
+        - Packaging / install / launch
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps_to_reproduce
+    attributes:
+      label: Steps to reproduce
+      description: List exact steps so someone else can reproduce it.
+      placeholder: |
+        1. Launch Browser Switch
+        2. Open the menu bar menu
+        3. Click ...
+        4. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual_behavior
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs_or_media
+    attributes:
+      label: Logs, screenshots, or recordings (optional)
+      description: Paste any terminal output or drag in screenshots/screen recordings if helpful.
+      render: shell
+
+  - type: checkboxes
+    id: pre_submit_checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues for duplicates.
+          required: true
+        - label: I checked the README/wiki for setup or usage guidance first.
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation and Installation Guide
+    url: https://github.com/adamabernathy/default-browser/wiki/Installation
+    about: Start here for install, uninstall, and launch help.
+  - name: Browser Switch Wiki
+    url: https://github.com/adamabernathy/default-browser/wiki
+    about: Review feature, settings, network/VPN, and architecture docs before filing a question.
+

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,57 @@
+name: Documentation update
+description: Report missing, incorrect, or unclear docs
+title: "Docs: "
+labels:
+  - documentation
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for README, wiki, install instructions, or contributor/repo documentation issues.
+
+  - type: dropdown
+    id: documentation_area
+    attributes:
+      label: Documentation area
+      options:
+        - README
+        - Wiki
+        - Installation instructions
+        - Contributor docs / templates
+        - Scripts help text
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: page_or_file
+    attributes:
+      label: Page or file (optional)
+      description: File path or URL if you know it.
+      placeholder: "e.g. README.md or wiki/Installation.md"
+
+  - type: textarea
+    id: issue_description
+    attributes:
+      label: What is wrong or missing?
+      description: Be specific about what is confusing, outdated, or incorrect.
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggested_improvement
+    attributes:
+      label: Suggested improvement
+      description: What should the docs say instead?
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: pre_submit_checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I checked the README and wiki pages for the answer.
+          required: true
+        - label: I searched existing documentation issues.
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,84 @@
+name: Feature request
+description: Propose a new feature or improvement
+title: "Feature: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Suggest a feature that improves Browser Switch for real-world daily use.
+
+        Please describe the user problem first, then your proposed solution. Product language is fine; implementation details are optional.
+
+  - type: textarea
+    id: problem_or_use_case
+    attributes:
+      label: Problem or use case
+      description: What are you trying to do that Browser Switch does not support well today?
+      placeholder: "When I am switching between work and personal browser contexts..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed_solution
+    attributes:
+      label: Proposed solution
+      description: What behavior or UI would you like to see?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives_considered
+    attributes:
+      label: Alternatives considered (optional)
+      description: Workarounds or other approaches you considered.
+
+  - type: dropdown
+    id: feature_area
+    attributes:
+      label: Feature area
+      options:
+        - Browser switching
+        - Menu bar UI / menu behavior
+        - Network / VPN context
+        - Power tools (Option key features)
+        - Run on Startup / settings
+        - Build / packaging / installation
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: ui_impact
+    attributes:
+      label: Does this change the UI or menu behavior?
+      options:
+        - "No"
+        - "Yes"
+        - Not sure
+    validations:
+      required: true
+
+  - type: textarea
+    id: success_criteria
+    attributes:
+      label: What would success look like?
+      description: Define the expected outcome (acceptance criteria if you have them).
+      placeholder: |
+        - I can ...
+        - The menu shows ...
+        - The action completes without opening System Settings
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: pre_submit_checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and feature requests.
+          required: true
+        - label: I understand Browser Switch targets macOS 14+.
+          required: true

.github/ISSUE_TEMPLATE/ui_ux.yml

@@ -0,0 +1,74 @@
+name: UI / UX issue
+description: Report a macOS UI, UX, HIG, or accessibility issue
+title: "UI/UX: "
+labels:
+  - hig
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for menu behavior, icons, accessibility, dark mode, alerts, or other macOS UX issues.
+
+        Browser Switch aims to match Apple Human Interface Guidelines and standard macOS menu bar extra behavior.
+
+  - type: dropdown
+    id: hig_category
+    attributes:
+      label: UI / UX category
+      options:
+        - Menus / menu structure
+        - SF Symbols / iconography
+        - Dark mode / contrast
+        - Accessibility (VoiceOver, labels, text vs color)
+        - Alerts / messaging
+        - About panel / app behavior
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: macos_version
+    attributes:
+      label: macOS version
+      placeholder: "e.g. macOS 15.3"
+    validations:
+      required: true
+
+  - type: textarea
+    id: current_behavior
+    attributes:
+      label: Current behavior
+      description: What does the app do today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+      description: What should it do instead to better match native macOS behavior?
+    validations:
+      required: true
+
+  - type: textarea
+    id: hig_reference
+    attributes:
+      label: HIG reference (optional)
+      description: Link the relevant Apple HIG page, or briefly describe which macOS system behavior it should match.
+      placeholder: "e.g. Apple HIG Menus / SF Symbols, or \"match Wi-Fi/Bluetooth menu behavior\""
+
+  - type: textarea
+    id: screenshots_or_examples
+    attributes:
+      label: Screenshots or examples (optional)
+      description: Add screenshots, recordings, or comparisons to system menu bar extras (Wi-Fi, Battery, Bluetooth, etc.).
+
+  - type: checkboxes
+    id: pre_submit_checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I checked existing UI/HIG issues for duplicates.
+          required: true
+        - label: I included enough detail to reproduce or evaluate the UX issue.
+          required: true