2026-04-27 17:25:51 +00:00
|
|
|
# Contributing to PaperForge
|
2026-04-27 09:59:18 +00:00
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
## Before submitting a PR
|
2026-04-27 09:59:18 +00:00
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
**Sync your fork first.** This avoids conflicts from outdated forks:
|
2026-04-27 09:59:18 +00:00
|
|
|
|
|
|
|
|
```bash
|
2026-05-10 04:02:07 +00:00
|
|
|
git remote add upstream https://github.com/LLLin000/PaperForge.git
|
|
|
|
|
git fetch upstream
|
|
|
|
|
git checkout master
|
|
|
|
|
git merge upstream/master
|
|
|
|
|
git push origin master
|
2026-04-27 09:59:18 +00:00
|
|
|
```
|
|
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
Then create your feature branch from the updated master:
|
2026-04-27 09:59:18 +00:00
|
|
|
|
|
|
|
|
```bash
|
2026-05-10 04:02:07 +00:00
|
|
|
git checkout -b my-feature upstream/master
|
2026-04-27 09:59:18 +00:00
|
|
|
```
|
|
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
## Code style
|
2026-04-27 09:59:18 +00:00
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
- Plugin (JS): follow existing patterns in `paperforge/plugin/`
|
|
|
|
|
- Python: `ruff check` and `ruff format` before committing
|
2026-04-27 09:59:18 +00:00
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
## PR checklist
|
2026-04-27 09:59:18 +00:00
|
|
|
|
2026-05-10 04:02:07 +00:00
|
|
|
- [ ] Fork synced with upstream master
|
|
|
|
|
- [ ] `ruff check && ruff format` passes
|
|
|
|
|
- [ ] `pytest tests/ --ignore=tests/sandbox --ignore=tests/e2e --ignore=tests/journey --ignore=tests/chaos --ignore=tests/audit -x` passes
|
|
|
|
|
- [ ] Plugin changes: `npx vitest run` in `paperforge/plugin/` passes
|