Skip to content

docs: add COLLABORATORS.md#4254

Open
reinkrul wants to merge 3 commits into
masterfrom
docs/collaborators-guide
Open

docs: add COLLABORATORS.md#4254
reinkrul wants to merge 3 commits into
masterfrom
docs/collaborators-guide

Conversation

@reinkrul
Copy link
Copy Markdown
Member

@reinkrul reinkrul commented May 18, 2026

Summary

  • Adds COLLABORATORS.md describing how to contribute: when to open an issue first, keep PRs small, signed commits, Conventional Commits, matching surrounding code conventions, tests, codegen via the makefile, and review etiquette (no force-push after review starts).
  • Points the existing contribution touchpoints at the new file instead of duplicating content:
    • README.rst — adds a "Contributing" section linking to it.
    • .github/README.md — adds a bullet in "For Contributors".
    • docs/pages/contribute.rst — slimmed to a pointer (was a one-liner already).

Test plan

  • Render COLLABORATORS.md on GitHub and check links resolve.
  • Render docs/pages/contribute.rst on Read the Docs and check the link resolves.

Assisted by AI

Covers small PRs, signed commits, Conventional Commits, code conventions,
tests, code generation via makefile, and review etiquette (no force-push
after review starts).

Assisted by AI
reinkrul added 2 commits May 18, 2026 11:29
Avoid duplicating contribution guidance across README.rst, .github/README.md,
and docs/pages/contribute.rst — each now links to COLLABORATORS.md.

Assisted by AI
README.rst is generated by 'rst_include include README_template.rst README.rst'
(via 'make cli-docs'). Update the template so the generated file stays in sync
with manual edits.

Assisted by AI
@qltysh
Copy link
Copy Markdown
Contributor

qltysh Bot commented May 18, 2026

Qlty


Coverage Impact

This PR will not change total coverage.

🚦 See full report on Qlty Cloud »

🛟 Help
  • Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

  • Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

  • File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

    • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

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