Skip to content

Add CONTRIBUTING.md and contributor quickstart - #9

Merged
Shellghostt merged 1 commit into
mainfrom
contributing-guide
Nov 9, 2026
Merged

Shellghostt merged 1 commit into
mainfrom
contributing-guide

Conversation

@Shellghostt

Copy link
Copy Markdown
Owner

Closes #5

What

Adds CONTRIBUTING.md and links it from the README, covering:

  • Setup — fork/clone, optional decaffeinator submodule for VAPT, virtualenv, pip install -e ".[dev]", Patchright Chromium, and --doctor.
  • Checks — pytest tests -q plus the webvac --doctor smoke check, matching what CI runs.
  • Python 3.11 compatibility — CI runs 3.11 and 3.12; calls out the f-string/backslash rule that bit the storage module.
  • Branch/PR workflow — branch from main, focused commits, conventional prefixes, Closes #N, green CI, no force-push after review, squash merge.
  • Adding tests — browser-free/network-free pytest tests under tests/.
  • Bug reports and security — required details, redaction, private security path.

README changes: the existing short "Contributing Workflow" section now points to the full guide, and CONTRIBUTING.md is added to the documentation index.

Verification

Docs-only change; no runtime behaviour touched. Links resolve to existing files (LICENSE, docs/SECURITY.md). CI will confirm the tree still builds and tests pass on all four matrix cells.

Covers dev setup (including the optional decaffeinator submodule), the
pytest + doctor checks, branch and PR workflow, adding browser-free tests,
Python 3.11 compatibility, and bug-report/security guidance.

Closes #5
@Shellghostt
Shellghostt merged commit bf1aea2 into main Nov 9, 2026
4 checks passed
@Shellghostt
Shellghostt deleted the contributing-guide branch November 9, 2026 03:14
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.

Add CONTRIBUTING.md and contributor quickstart

1 participant