Files
ArchyHCL/.github/ISSUE_TEMPLATE/hardware-report.yml
T
ssmithxandClaude Sonnet 5 a22a9c9826
Build and validate / build (push) Successful in 1m38s
Initial scaffold: ArchyHCL, a community hardware compatibility list for Archipelago
Modeled on three researched precedents (see README): OpenWrt's Table of
Hardware for the browsable sortable/filterable table UX, postmarketOS's
working/community/testing tiers for the status field (collapsed to
working/partial/broken here), and RaspiBlitz's scattered GitHub-issues
approach as a negative example to avoid — hence structured YAML report
files validated against a JSON Schema instead of free-text issue threads.

- data/reports/*.yml + data/schema.json: one file per report, schema
  requires `issues` whenever status is partial/broken
- scripts/build.py: validates every report and builds site/data.json,
  fails loudly on bad data (same idea as archy's own
  validate-app-manifest.sh)
- site/: plain HTML/CSS/JS, no framework or build step, fetches data.json
  client-side — search, filter by status/form-factor, sortable columns,
  click a row for issues/notes detail
- .github/ISSUE_TEMPLATE/hardware-report.yml: structured submission path
  for contributors who don't want to touch git directly
- .gitea/workflows/ci.yml: runs the build/validate step on push and PRs

Not yet deployed anywhere — see README's Deployment section.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-01 11:32:58 +00:00

117 lines
2.9 KiB
YAML

name: Hardware report
description: Report a device you've installed Archipelago on, working or not.
title: "hw: <device model>"
labels: ["hardware-report"]
body:
- type: markdown
attributes:
value: |
Thanks for reporting! A maintainer turns this into a data file under
`data/reports/` and it shows up on the site. If you're comfortable
with git, opening a PR directly is faster — see CONTRIBUTING.md.
- type: input
id: device_model
attributes:
label: Device model
placeholder: "Lenovo ThinkPad T430"
validations:
required: true
- type: dropdown
id: form_factor
attributes:
label: Form factor
options:
- laptop
- desktop
- mini-pc
- sbc
- server
- other
validations:
required: true
- type: input
id: cpu
attributes:
label: CPU
placeholder: "Intel Core i5-3320M"
validations:
required: true
- type: input
id: ram_gb
attributes:
label: RAM (GB)
placeholder: "8"
validations:
required: true
- type: input
id: storage
attributes:
label: Storage (type and size)
placeholder: "256GB SSD"
validations:
required: true
- type: input
id: wifi_chip
attributes:
label: WiFi chip
description: Exact chipset if you know it. Put "none" if wired-only.
placeholder: "Intel Centrino Advanced-N 6205"
validations:
required: true
- type: input
id: ethernet
attributes:
label: Ethernet chip (optional)
placeholder: "Intel 82579LM"
- type: input
id: archy_version
attributes:
label: Archipelago version tested
placeholder: "1.8.4-alpha"
validations:
required: true
- type: dropdown
id: install_method
attributes:
label: Install method
options:
- usb-iso
- netboot
- existing-os-script
- other
validations:
required: true
- type: dropdown
id: status
attributes:
label: Status
description: "working = no known issues. partial = runs with specific known issues (describe below). broken = does not install or run."
options:
- working
- partial
- broken
validations:
required: true
- type: input
id: tested_date
attributes:
label: Date tested
placeholder: "2026-08-21"
validations:
required: true
- type: textarea
id: issues
attributes:
label: Issues (required if status is partial or broken)
description: What broke, and any workaround you found.
- type: textarea
id: notes
attributes:
label: Other notes
description: BIOS/UEFI settings needed, quirks, links to a fuller writeup.
- type: input
id: submitted_by
attributes:
label: Attribution (optional)
description: Your npub, Gitea username, or leave blank to stay anonymous.