Skip to content

Comments

Update Code of Conduct attribution to Contributor Covenant v2.1#758

Open
sambhavi0 wants to merge 6 commits intoCircuitVerse:masterfrom
sambhavi0:patch-2
Open

Update Code of Conduct attribution to Contributor Covenant v2.1#758
sambhavi0 wants to merge 6 commits intoCircuitVerse:masterfrom
sambhavi0:patch-2

Conversation

@sambhavi0
Copy link

@sambhavi0 sambhavi0 commented Jan 18, 2026

Updates the Code of Conduct attribution to Contributor Covenant v2.1 and makes minor wording improvements for clarity and inclusivity

A meaningful title for PR, not like: made changes to xyz.md

Changes done:

  • Updated Code of Conduct attribution to Contributor Covenant v2.1
  • Made minor wording improvements for clarity and inclusivity

Screenshots: Not applicable (documentation only change)

Preview Link(s): Not applicable (documentation only change)

✅️ By submitting this PR, I have verified the following

  • Checked to see if a similar PR has already been opened 🤔️
  • Reviewed the contributing guidelines 🔍️
  • Sample preview link added (add the link(s) for all the pages changed/updated from the checks tab after checks complete)
  • Tried Squashing the commits into one

Summary by CodeRabbit

  • Documentation
    • Updated Code of Conduct to Contributor Covenant v2.1: streamlined attribution and URL, reorganized headings and section order, moved former "Our Responsibilities" content inline under behavior lists, and realigned "Scope" and "Enforcement" sections for clarity.

Updates the Code of Conduct attribution to Contributor Covenant v2.1 and makes minor wording improvements for clarity and inclusivity
@coderabbitai
Copy link

coderabbitai bot commented Jan 18, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

Walkthrough

The CODE_OF_CONDUCT.md was reorganized: section headings were renamed and reordered, the "Our Responsibilities" header was removed with its content moved inline under behavior lists, and the "Scope" and "Enforcement" headers were realigned. Attribution was updated to reference Contributor Covenant v2.1 with its URL. Lines changed: +8/-20 and +18/-30.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: updating Code of Conduct attribution to Contributor Covenant v2.1, which is the primary focus of the PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@CODE_OF_CONDUCT.md`:
- Around line 43-45: Remove the duplicate markdown header by deleting the extra
"## Attribution" occurrence so only one "## Attribution" header remains; locate
the repeated header text "## Attribution" in the file and remove the second
instance, leaving the rest of the document content unchanged.
- Around line 47-51: Remove the unused reference label "[version]" from
CODE_OF_CONDUCT.md and replace the bare URL
"https://www.contributor-covenant.org/version/2/1/code_of_conduct.html" with a
reference-style link (e.g., add a new reference like [code_of_conduct]:
https://www.contributor-covenant.org/version/2/1/code_of_conduct.html and use
that reference in the body) so the document uses consistent reference-style
links and no unused reference labels remain.
🧹 Nitpick comments (1)
CODE_OF_CONDUCT.md (1)

37-39: Consider minor wording improvements for clarity.

The enforcement section updates look good overall. Consider these optional refinements:

  • Line 37: "project-designated" (with hyphen) is more grammatically correct than "project designated"
  • Line 39: "regarding" is more concise than "with regard to"
📝 Optional wording improvements
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at a project designated contact address. All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at a project-designated contact address. All complaints will be reviewed and investigated promptly and fairly.

-The project team is committed to maintaining confidentiality with regard to the reporter of an incident, consistent with the need to investigate and address the reported behavior.
+The project team is committed to maintaining confidentiality regarding the reporter of an incident, consistent with the need to investigate and address the reported behavior.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CODE_OF_CONDUCT.md`:
- Line 5: The sentence "we as contributors and maintainers pledge to making
participation in our project and community a harassment-free experience..." is
ungrammatical; update the phrase "pledge to making" to "pledge to make" so it
reads "we as contributors and maintainers pledge to make participation in our
project and community a harassment-free experience for everyone..." — locate
that sentence (the one beginning "In the interest of fostering an open and
welcoming environment...") and replace the verb phrase accordingly.
🧹 Nitpick comments (1)
CODE_OF_CONDUCT.md (1)

37-39: Minor style: hyphenate and tighten wording.
Optional clarity polish.

✏️ Proposed fix
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at a project designated contact address. All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at a project-designated contact address. All complaints will be reviewed and investigated promptly and fairly.
 
-The project team is committed to maintaining confidentiality with regard to the reporter of an incident, consistent with the need to investigate and address the reported behavior.
+The project team is committed to maintaining confidentiality regarding the reporter of an incident, consistent with the need to investigate and address the reported behavior.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Fix all issues with AI agents
In `@CODE_OF_CONDUCT.md`:
- Around line 45-47: Replace the existing attribution line "This Code of Conduct
is adapted from the [Contributor Covenant][homepage], version 2.1." and the
corresponding [homepage] link with the official recommended attribution text and
URL: use "This Code of Conduct is adapted from the Contributor Covenant, version
2.1, available at
https://www.contributor-covenant.org/version/2/1/code_of_conduct.html" and
update the [homepage] reference (if still used) to point to the .html URL so the
document matches the Contributor Covenant v2.1 official format.
- Around line 37-39: Replace the current enforcement section text with the exact
Contributor Covenant v2.1 enforcement wording: use "community leaders
responsible for enforcement at [INSERT CONTACT METHOD]" (replace current
"project maintainers" and "project designated contact address"), hyphenate
"project-designated" where used, and use the official privacy sentence "All
community leaders are obligated to respect the privacy and security of the
reporter of any incident." Ensure the replaced block exactly matches the CC v2.1
enforcement section wording.
- Line 5: The Code of Conduct pledge in CODE_OF_CONDUCT.md does not match
Contributor Covenant v2.1 despite the attribution; either replace the current
pledge paragraph and opening sentence with the exact official v2.1 text
(including the missing second pledge sentence and all protected categories such
as visible/invisible disability, sex characteristics, education, socio-economic
status, caste, color) or change the attribution line that claims v2.1 to
correctly reflect the actual version/derivation; update the opening phrase to
the official "We as members, contributors, and leaders" if adopting v2.1 and
ensure the entire document matches the official v2.1 wording exactly if you keep
that attribution.

Comment on lines 37 to 39
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at a project designated contact address. All complaints will be reviewed and investigated promptly and fairly.

The project team is committed to maintaining confidentiality with regard to the reporter of an incident, consistent with the need to investigate and address the reported behavior.
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🌐 Web query:

Contributor Covenant version 2.1 enforcement section official text

💡 Result:

The official "Enforcement" section for Contributor Covenant v2.1 states (paraphrased):

  • Reports of abusive, harassing, or unacceptable behavior should be sent to the community leaders at the project's specified contact method.
  • Complaints will be reviewed and investigated promptly and fairly.
  • Community leaders must respect the reporter’s privacy and security.

For the exact official wording, see the Contributor Covenant v2.1 page. [1]

Reference:
[1] Contributor Covenant — Version 2.1, Code of Conduct (Enforcement section). https://www.contributor-covenant.org/version/2/1/code_of_conduct/


🏁 Script executed:

# Let's also check if there are any other references to hyphenation rules for "project designated"
rg "project.designated" --type md -i

Repository: CircuitVerse/Interactive-Book

Length of output: 324


🌐 Web query:

Contributor Covenant 2.1 complete enforcement section exact wording community leaders

💡 Result:

Enforcement Responsibilities

Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.

Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate. [1]

Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [INSERT CONTACT METHOD]. All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the reporter of any incident. [1]

Source: Contributor Covenant version 2.1 (official text). [1]


🏁 Script executed:

# Check the full context of lines around 37-39 in the file to see the complete enforcement section
cat -n CODE_OF_CONDUCT.md | sed -n '30,45p'

Repository: CircuitVerse/Interactive-Book

Length of output: 1368


Replace enforcement section to match Contributor Covenant v2.1; fix hyphenation.

The enforcement section (lines 37-39) deviates significantly from the official Contributor Covenant v2.1 text. Since the file attributes itself to CC v2.1, the enforcement section should match the official wording exactly. Key differences:

  1. Line 37: Uses "project maintainers" and "project designated contact address" instead of the official "community leaders responsible for enforcement at [INSERT CONTACT METHOD]"—and "project designated" should be hyphenated as "project-designated" (compound adjective).

  2. Line 39: The privacy language differs from the official text. CC v2.1 states "All community leaders are obligated to respect the privacy and security of the reporter of any incident," but the current text adds different phrasing about investigating and addressing behavior.

Replace with the official CC v2.1 enforcement section to ensure consistency with the claimed source attribution.

🧰 Tools
🪛 LanguageTool

[grammar] ~37-~37: Use a hyphen to join words.
Context: ...ing the project maintainers at a project designated contact address. All complain...

(QB_NEW_EN_HYPHEN)


[style] ~39-~39: ‘with regard to’ might be wordy. Consider a shorter alternative.
Context: ...ommitted to maintaining confidentiality with regard to the reporter of an incident, consistent...

(EN_WORDINESS_PREMIUM_WITH_REGARD_TO)

🤖 Prompt for AI Agents
In `@CODE_OF_CONDUCT.md` around lines 37 - 39, Replace the current enforcement
section text with the exact Contributor Covenant v2.1 enforcement wording: use
"community leaders responsible for enforcement at [INSERT CONTACT METHOD]"
(replace current "project maintainers" and "project designated contact
address"), hyphenate "project-designated" where used, and use the official
privacy sentence "All community leaders are obligated to respect the privacy and
security of the reporter of any incident." Ensure the replaced block exactly
matches the CC v2.1 enforcement section wording.

@sambhavi0
Copy link
Author

Hi maintainers!
Just a gentle follow up on this documentation PR.
Whenever you have time, I’d really appreciate a review.
Thanks

Copy link
Member

@JatsuAkaYashvant JatsuAkaYashvant left a comment

Choose a reason for hiding this comment

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

@sambhavi0, We should only update the Code of Conduct URL, as the other changes make it less descriptive.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CODE_OF_CONDUCT.md`:
- Around line 1-2: Restore Markdown headings and update the document to v2.1:
add appropriate '#' markers to the heading lines that were stripped (e.g.,
"Contributor Covenant Code of Conduct", "Our Pledge", the section heading
containing the pledge text, "Enforcement", "Attribution"); fix the pledge
sentence "pledge to making" -> "pledge to make" and insert the missing protected
categories per v2.1 (sex characteristics, education, socio‑economic status,
caste, color); replace the current Enforcement section body with the v2.1
enforcement template using the [INSERT CONTACT METHOD] placeholder and wording
that emphasizes community leader responsibilities and reporter privacy/security;
update the Attribution block to the correct v2.1 attribution text, mark the URL
as a Markdown link (e.g.,
[https://www.contributor-covenant.org/version/2/1/code_of_conduct/](https://www.contributor-covenant.org/version/2/1/code_of_conduct/))
and ensure the stated version matches the content.

---

Duplicate comments:
In `@CODE_OF_CONDUCT.md`:
- Around line 33-34: The attribution claims Contributor Covenant v2.1 but the
document body still contains v1.x wording; either replace the entire
CODE_OF_CONDUCT.md body with the official v2.1 text (including the updated
Pledge paragraph and the v2.1 Enforcement section wording) or change the
attribution line back to the correct older version; update the pledge paragraph
(the opening "Pledge" text) and the "Enforcement" paragraph (the contact/method
wording) to exactly match the official v2.1 language so the footer attribution
and document body are consistent.
- Line 34: The bare URL
"https://www.contributor-covenant.org/version/2/1/code_of_conduct.html" in the
line containing "Contributor Covenant, version 2.1" is causing an MD034
regression; update that line to replace the raw URL with a markdown link (e.g.,
[Contributor Covenant, version
2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html)) so
the attribution is wrapped as a link and the MD034 lint rule is satisfied.

Comment on lines 1 to 2
Contributor Covenant Code of Conduct
Our Pledge
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Confirm whether heading markers (# / ## / ###) are present in CODE_OF_CONDUCT.md,
# and also dump the first 35 lines to inspect pledge and enforcement text.

echo "=== Markdown headings found ==="
rg -n "^#{1,6}\s" CODE_OF_CONDUCT.md

echo ""
echo "=== Full file dump (first 35 lines) ==="
head -35 CODE_OF_CONDUCT.md

Repository: CircuitVerse/Interactive-Book

Length of output: 3222


🌐 Web query:

Contributor Covenant Code of Conduct version 2.1 official text pledge enforcement

💡 Result:

Contributor Covenant Code of Conduct v2.1 — official text (key sections)

  • Our Pledge: Members/contributors/leaders pledge a “harassment-free experience for everyone” (followed by a detailed list of protected characteristics) and to act in ways that support an “open, welcoming, diverse, inclusive, and healthy community.” [1]

  • Enforcement Responsibilities: Community leaders are responsible for clarifying/enforcing standards and taking “appropriate and fair corrective action” in response to behavior they deem inappropriate/threatening/offensive/harmful; they may “remove, edit, or reject” contributions not aligned with the CoC and communicate reasons when appropriate. [1]

  • Enforcement: Reports of abusive/harassing/unacceptable behavior may be made to the designated enforcement contacts (“[INSERT CONTACT METHOD]” in the template); complaints will be reviewed/investigated “promptly and fairly,” and leaders must respect the reporter’s “privacy and security.” [1]

Source: Contributor Covenant Code of Conduct v2.1 (official page). [1]


Critical formatting regression: markdown heading markers are completely missing from the file.

The file contains no markdown heading syntax (#, ##, etc.) — all section headings are plain text paragraphs. This causes the entire document to render without visual structure. All changed heading lines (1, 2, 5, 20, 25, 28, 33) require restoration of their heading markers.

Additionally:

  • Pledge text (line 3) contains grammatical error: "pledge to making" should be "pledge to make". Also missing protected categories per official v2.1 (sex characteristics, education, socio-economic status, caste, color).
  • Enforcement section (line 29) uses outdated v1.x language and specific email contact, not the v2.1 template structure with [INSERT CONTACT METHOD] placeholder and emphasis on community leader responsibilities and reporter privacy/security.
  • Attribution (line 34) claims "version 2.1" but the pledge and enforcement content are v1.x — this version mismatch must be resolved by updating to actual v2.1 text. Also, the URL is bare (no markdown link syntax); wrap it as [https://...](https://...) to fix MD034 linting violation.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CODE_OF_CONDUCT.md` around lines 1 - 2, Restore Markdown headings and update
the document to v2.1: add appropriate '#' markers to the heading lines that were
stripped (e.g., "Contributor Covenant Code of Conduct", "Our Pledge", the
section heading containing the pledge text, "Enforcement", "Attribution"); fix
the pledge sentence "pledge to making" -> "pledge to make" and insert the
missing protected categories per v2.1 (sex characteristics, education,
socio‑economic status, caste, color); replace the current Enforcement section
body with the v2.1 enforcement template using the [INSERT CONTACT METHOD]
placeholder and wording that emphasizes community leader responsibilities and
reporter privacy/security; update the Attribution block to the correct v2.1
attribution text, mark the URL as a Markdown link (e.g.,
[https://www.contributor-covenant.org/version/2/1/code_of_conduct/](https://www.contributor-covenant.org/version/2/1/code_of_conduct/))
and ensure the stated version matches the content.

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.

2 participants