Skip to content

Update contributor docs: CoC 2.1, completeness, link fixes#21614

Open
Borda wants to merge 7 commits intomasterfrom
docs/contrib-guide
Open

Update contributor docs: CoC 2.1, completeness, link fixes#21614
Borda wants to merge 7 commits intomasterfrom
docs/contrib-guide

Conversation

@Borda
Copy link
Copy Markdown
Collaborator

@Borda Borda commented Mar 26, 2026

What does this PR do?

  • Upgrade CODE_OF_CONDUCT.md from Contributor Covenant 1.4 to 2.1 (tiered enforcement ladder, expanded pledge)
  • Add project conventions section to CONTRIBUTING.md (line length, Ruff rules, MyPy, rank_zero_*, callback hook convention)
  • Add two-package architecture overview and Python 3.9+ requirement to CONTRIBUTING.md
  • Fix broken/dead links in CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md
  • Rewrite tests/README.md: test layout tree, RunIf decorator, markers, standalone tests, coverage commands for both packages
Before submitting
  • Was this discussed/agreed via a GitHub issue? (not for typos and docs)
  • Did you read the contributor guideline, Pull Request section?
  • Did you make sure your PR does only one thing, instead of bundling different changes together?
  • Did you make sure to update the documentation with your changes? (if necessary)
  • Did you write any new necessary tests? (not for typos and docs)
  • Did you verify new and existing tests pass locally with your changes?
  • Did you list all the breaking changes introduced by this pull request?
  • Did you update the CHANGELOG? (not for typos, docs, test updates, or minor internal changes/refactors)

PR review

Anyone in the community is welcome to review the PR.
Before you start reviewing, make sure you have read the review guidelines. In short, see the following bullet-list:

Reviewer checklist
  • Is this pull request ready for review? (if not, please submit in draft mode)
  • Check that all items from Before submitting are resolved
  • Make sure the title is self-explanatory and the description concisely explains the PR
  • Add labels and milestones (and optionally projects) to the PR so it can be classified

📚 Documentation preview 📚: https://pytorch-lightning--21614.org.readthedocs.build/en/21614/

- Upgrade CODE_OF_CONDUCT.md from Contributor Covenant 1.4 to 2.1 (tiered enforcement ladder, expanded pledge)
- Add project conventions section to CONTRIBUTING.md (line length, Ruff rules, MyPy, rank_zero_*, callback hook convention)
- Add two-package architecture overview and Python 3.9+ requirement to CONTRIBUTING.md
- Fix broken/dead links in CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md
- Rewrite tests/README.md: test layout tree, RunIf decorator, markers, standalone tests, coverage commands for both packages

---
Co-authored-by: Claude Code <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 26, 2026 10:49
@github-actions github-actions bot added the ci Continuous Integration label Mar 26, 2026
@github-actions
Copy link
Copy Markdown
Contributor

⚡ Required checks status: All passing 🟢

No groups match the files changed in this PR.


Thank you for your contribution! 💜

Note
This comment is automatically generated and updates for 70 minutes every 180 seconds. If you have any other questions, contact carmocca for help.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation refresh for contributors and maintainers, updating community guidelines, contributor conventions, and test-running instructions to reflect the repo’s current structure and CI expectations.

Changes:

  • Updated Code of Conduct to Contributor Covenant v2.1 with enforcement guidelines.
  • Expanded CONTRIBUTING.md with repo architecture and contributor conventions (linting, typing, rank-aware utilities, callback-hook process).
  • Reworked tests/README.md with new test layout, RunIf usage, coverage commands, and updated local/CI guidance; fixed template link(s).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

File Description
tests/README.md Rewrites test documentation (layout, commands, RunIf/markers/standalone/coverage).
.github/PULL_REQUEST_TEMPLATE.md Updates documentation links used in PRs.
.github/CONTRIBUTING.md Adds repo architecture + conventions (lint/type/rank-aware/callback-hook guidance).
.github/CODE_OF_CONDUCT.md Upgrades CoC content to Contributor Covenant 2.1 (incl. enforcement ladder).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Borda and others added 4 commits March 26, 2026 13:57
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
[resolve #2] Review comment by @Copilot (PR #21614):
"These commands run run_standalone_tasks.sh from the tests/ directory, but the script
explicitly assumes it is run with the working directory tests/tests_pytorch and uses
relative paths that will fail otherwise."

---
Co-authored-by: Claude Code <noreply@anthropic.com>
[resolve #5] Review comment by @Copilot (PR #21614):
"Consider linking to the contributing guide in the current repo (preferably via a
relative link) to avoid sending reviewers to a potentially different/outdated document."

---
Co-authored-by: Claude Code <noreply@anthropic.com>
@Borda Borda enabled auto-merge (squash) March 30, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci Continuous Integration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants