Skip to content

Add public-feedback infrastructure - #20

Merged
maphew merged 2 commits into
mainfrom
public-readiness
Jul 17, 2026
Merged

maphew merged 2 commits into
mainfrom
public-readiness

Conversation

@maphew

@maphew maphew commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Prepares the repo for the public-feedback phase (Beads epic mdo-2xi): make mdo presentable to strangers, easy to critique, honest about where it stands.

Changes

  • CONTRIBUTING.md — frames outside experience reports as the most valuable contribution right now; documents build/test quality gates; candidly discloses the AI-assisted development workflow so nobody discovers it in the commit log instead.
  • SECURITY.md — private vulnerability reporting channel plus threat-model scope notes (no runtime network, sanitize-by-default, per-user reversible integration, ShellExecuteW launches).
  • Issue templates — structured bug report (OS / install method / exact action up front) and a low-pressure experience-report form that explicitly welcomes "this shouldn't exist because X". Config links Discussions and private security reporting.
  • README — new "Project status — feedback wanted" section after the Why: v0.5 shipped / v0.6 in progress, Windows+Linux exercised daily, macOS least tested, and a direct invitation to full-strength critique. README.html regenerated.

Repo settings applied directly (not in this diff)

  • Discussions enabled; private vulnerability reporting enabled
  • Description tightened; topics added: rust, cli, html5, markdown-to-html, markdown-converter, windows, linux, macos

Validation

  • cargo test --all-targets green locally (GNU toolchain; 39 tests)
  • README.html regenerated with the current release build

🤖 Generated with Claude Code

https://claude.ai/code/session_017xsELYfbDMYGtwQuY4cnA2

maphew and others added 2 commits July 15, 2026 23:17
Prepare the repo to invite outside critique (Beads mdo-2xi):

- CONTRIBUTING.md: feedback-first contribution guide with build/test
  gates and a candid note on AI-assisted development
- SECURITY.md: private reporting channel and threat-model scope notes
- Issue templates: bug report and experience report forms, plus
  contact links to Discussions and private security reporting
- README: honest project-status section inviting critique, with
  regenerated README.html

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xsELYfbDMYGtwQuY4cnA2
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xsELYfbDMYGtwQuY4cnA2
@kilo-code-bot

kilo-code-bot Bot commented Jul 16, 2026 •

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (8 files)
  • .beads/interactions.jsonl
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/experience_report.yml
  • CONTRIBUTING.md
  • README.html
  • README.md
  • SECURITY.md

Reviewed by step-3.7-flash · Input: 100.3K · Output: 3.8K · Cached: 305.9K

@maphew
maphew merged commit 6a79808 into main Jul 17, 2026
3 checks passed
@maphew
maphew deleted the public-readiness branch July 17, 2026 16:49
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