2 Commits
Author SHA1 Message Date
Zakk 9fba5a63b1 docs: tighten the contribution rules for assisted pull requests
Recent pull requests left the "Submitted and answered for by" line
filled in by an assistant or dropped, kept a commit that a later
commit reverted, and described changes their diff no longer had.
CONTRIBUTING.md also told contributors to run "the checks CI runs",
but CI runs neither go vet nor go test, and it named Go 1.26 while
core/ needs 1.27.

- CONTRIBUTING.md: Go 1.27; say which checks CI runs; squash a commit that undoes part of an earlier one; a bug fix
  comes with a failing test or a reproduced failure; check the title,
  description and messages against the diff; the sign-off line and the
  boxes are the contributor's.
- AGENTS.md: ask before changing behaviour that may be intentional; a
  check that ran nothing proves nothing; leave the sign-off line and
  the human's boxes alone.
- Pull request templates: the sign-off line is required and written by
  the contributor.
2026-11-13 02:17:08 +11:00
Zakk 154f016fdd docs: a contributing guide, an agents file, a pull request template and issue forms
The repository had six markdown issue templates, no pull request template and
no guide, so a report rarely said which version it was and a pull request
rarely said what its author had run.

The issue templates become four GitHub forms, English and Chinese kept apart,
asking for the version and why it is not the latest, the system and install
method, the transparent proxy mode, the steps, the logs and the person who
answers for the report. Usage questions go to Discussions through config.yml,
and blank issues are off. The pull request template, also in two languages,
asks for the change in the author's own words, what was executed and observed,
and a checklist of what the review expects; two of its boxes are true only of
someone who checked the list without reading it, or of an agent submitting
without human review, and checking either one closes the pull request.

CONTRIBUTING.md says where the code lives, what to run before opening a pull
request, that all six locales change together and that no AI attribution goes
into the history. AGENTS.md tells an assistant the same in its own terms, with
the traps that cost a review round: the web files the service embeds, the
locale and documentation directories that are named differently, the escaped
@ in a locale string, the Material colour and type tokens, and what in core/
belongs to v2rayA rather than to xray-core.
2026-09-22 21:54:12 +10:00