Skip to content

docs: add open source contribution guidelines and CI#5

Merged
eagle-head merged 2 commits intomainfrom
docs/contribution-guidelines
Mar 4, 2026
Merged

docs: add open source contribution guidelines and CI#5
eagle-head merged 2 commits intomainfrom
docs/contribution-guidelines

Conversation

@eagle-head
Copy link
Copy Markdown
Owner

Summary

  • Add complete contribution infrastructure following best practices from major open source projects (React, Vue, Vite, Vitest)
  • Add CI workflow to automatically validate PRs (lint, typecheck, test, build)
  • Add MIT LICENSE file

New Files

File Description
CONTRIBUTING.md Full contributor guide: setup, workflow, conventions, testing
CODE_OF_CONDUCT.md Contributor Covenant v3.0
LICENSE MIT license
.github/commit-convention.md Conventional Commits guide with types, scopes, examples
.github/ISSUE_TEMPLATE/bug_report.yml Bug report form with validation
.github/ISSUE_TEMPLATE/feature_request.yml Feature request form
.github/ISSUE_TEMPLATE/config.yml Disables blank issues, links to Discussions
.github/PULL_REQUEST_TEMPLATE.md PR checklist template
.github/workflows/ci.yml CI: lint + typecheck + test (Node 18/20) + build

Modified Files

  • README.md — Replaced inline contributing steps with links to CONTRIBUTING.md and CODE_OF_CONDUCT.md. Removed reference to non-existent AGENTS.md.

Test plan

  • Verify issue templates render correctly on GitHub (/issues/new/choose)
  • Verify PR template appears when opening a new PR
  • Verify CI workflow runs on this PR
  • Review CONTRIBUTING.md for accuracy against current project setup
  • Verify LICENSE is recognized by GitHub (badge appears on repo page)

Add complete contribution infrastructure following best practices from
major open source projects (React, Vue, Vite, Vitest):

- CONTRIBUTING.md with setup, workflow, conventions, and testing guide
- CODE_OF_CONDUCT.md (Contributor Covenant v3.0)
- LICENSE file (MIT)
- Commit convention guide (.github/commit-convention.md)
- GitHub issue templates (bug report + feature request, YAML format)
- Pull request template with checklist
- CI workflow (lint, typecheck, test on Node 18/20, build)
- Updated README.md contributing section
@eagle-head eagle-head self-assigned this Mar 4, 2026
@eagle-head eagle-head added the documentation Improvements or additions to documentation label Mar 4, 2026
- Run prettier --write on 5 files with formatting inconsistencies
- Build core before typecheck in CI so react can resolve core types
@eagle-head eagle-head merged commit ac91b4e into main Mar 4, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant