Skip to content

docs: add security policy, releasing guide, roadmap and issue templates - #51

Merged
Mastersam07 merged 2 commits into
devfrom
docs/repository-presentation
Sep 24, 2026
Merged

Mastersam07 merged 2 commits into
devfrom
docs/repository-presentation

Conversation

@Mastersam07

@Mastersam07 Mastersam07 commented Sep 24, 2026 •

Copy link
Copy Markdown
Owner

What: Issue forms for bug reports and feature requests, a SECURITY.md, a RELEASING.md for maintainers, a ROADMAP.md, and changelog entries for what has landed since it was written.

The bug form requires the app version, macOS, Xcode version and build, device, runtime and Apple silicon or Intel, and points at odhub doctor, which prints nearly all of it. SECURITY.md says plainly what the app does to a machine, since loading private frameworks out of someone's Xcode is unusual enough to state out loud. RELEASING.md covers the process, the secret names, how to read a notarization log and what to do when a release fails at each stage. ROADMAP.md says where the README's limitations list is going, with the uncertain items marked as uncertain rather than promised.

Verification: Both issue forms parse as YAML. scripts/changelog-section.py 0.1.0 still reads the changelog and still exits 1 for a version that is not there. Repository topics checked: the eight intended ones were already set.

Follow-ups: The repository description claims deep links, push, proxy certs and hot reload. Those are on the roadmap, not in the product, so the description is ahead of the code. Left alone rather than changed quietly, since it is public positioning.

A bug report is only useful with the Xcode, device and runtime it happened on, so the form asks for them.
Says where the limitations list is going, with the uncertain items marked as uncertain rather than promised.
@Mastersam07 Mastersam07 changed the title docs: add security policy, releasing guide and issue templates docs: add security policy, releasing guide, roadmap and issue templates Sep 24, 2026
@Mastersam07
Mastersam07 merged commit 8b43236 into dev Sep 24, 2026
2 checks passed
@Mastersam07
Mastersam07 deleted the docs/repository-presentation branch September 24, 2026 05:09
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