Skip to content

Conversation

@ssz2605
Copy link
Contributor

@ssz2605 ssz2605 commented Jul 4, 2025

This PR improves the project's documentation by:

Adding a CONTRIBUTING.md with setup and contribution guidelines

Adding a CODE_OF_CONDUCT.md to ensure a respectful contributor environment

Updating the README.md

These changes aim to make it easier for new contributors to get started and align the repo with open-source best practices.
closes #431

Summary by CodeRabbit

  • Documentation
    • Added a Code of Conduct outlining community standards and reporting procedures.
    • Introduced a comprehensive contributing guide with setup, testing, build instructions, and troubleshooting tips.
    • Simplified the README by referring users to the new contributing guide for detailed setup and usage instructions.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jul 4, 2025

Walkthrough

Two new documentation files, CONTRIBUTING.md and CODE_OF_CONDUCT.md, have been added to the repository, providing contributor guidelines and a code of conduct. The README.md has been revised to direct users to the new CONTRIBUTING.md for setup and contribution instructions, removing previous detailed sections.

Changes

File(s) Change Summary
CODE_OF_CONDUCT.md Added Contributor Covenant Code of Conduct v2.0 outlining community standards and enforcement.
CONTRIBUTING.md Added detailed contributor guidelines, setup instructions, testing, build steps, and resources.
README.md Removed setup, testing, build, and resource sections; now refers to CONTRIBUTING.md for details.

Assessment against linked issues

Objective Addressed Explanation
Add CONTRIBUTING.md with project setup, guidelines, and onboarding details (#431)
Add CODE_OF_CONDUCT.md based on Contributor Covenant for a safe, inclusive environment (#431)

Poem

In burrows deep, the docs now shine,
With rules and guides in every line.
New rabbits join, they’ll never fear—
Conduct and tips are crystal clear!
So hop along, contribute too,
This warren’s ready—all thanks to you!
🐇✨


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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@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

🧹 Nitpick comments (4)
CODE_OF_CONDUCT.md (1)

30-37: Minor wording nitpick

Line 32 (“Trolling, insulting or derogatory comments…”) triggered a LanguageTool style hint about variety. Consider “harassing, insulting, or derogatory comments”. Purely stylistic; ignore if you prefer the current phrasing.

CONTRIBUTING.md (3)

20-21: Broken link: redme.md typo

docs/docker-compose/redme.mdreadme.md. The current link 404s on GitHub.


12-16: Duplicate “Setup” heading – collapse for clarity

You have ## 🛠️ Setup Instructions (line 7) and a second ## Setup (line 14). Merge them to avoid redundancy.


24-25: HTML <br> inside Markdown list may not render as intended

</br> is invalid HTML and unnecessary in GitHub lists. Replace with a blank line or <br/>.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4905d3b and 4bac9f0.

📒 Files selected for processing (3)
  • CODE_OF_CONDUCT.md (1 hunks)
  • CONTRIBUTING.md (1 hunks)
  • README.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
CONTRIBUTING.md

[uncategorized] ~58-~58: You might be missing the article “the” here.
Context: ...ic key in tauri.conf.json as pubkey and private key and password in Environment Variabl...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

CODE_OF_CONDUCT.md

[style] ~32-~32: Try using a synonym here to strengthen your wording.
Context: ...ind * Trolling, insulting or derogatory comments, and personal or political attacks * Pu...

(COMMENT_REMARK)


[uncategorized] ~120-~120: You might be missing the article “the” here.
Context: ....org/version/2/0/code_of_conduct.html. Community Impact Guidelines were inspired by [Moz...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

🪛 Gitleaks (8.26.0)
CONTRIBUTING.md

63-63: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)

🪛 markdownlint-cli2 (0.17.2)
CODE_OF_CONDUCT.md

3-3: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🔇 Additional comments (2)
CODE_OF_CONDUCT.md (1)

1-3: Heading level jump flagged by markdown-lint — verify before merging

markdownlint-cli2 raised MD001 (“heading levels should only increment by one”) at line 3.
Inspection looks fine (###), but the linter’s complaint suggests something else (perhaps a hidden heading or an extra ### in the raw file). Run the linter locally and fix/ignore as appropriate so CI stays green.

README.md (1)

58-60: Nice delegation to CONTRIBUTING.md

The slimmed-down README keeps the front page concise while pushing details to the new guide. Good move.

Comment on lines +60 to +68
There is a preset pubkey in tauri.conf.json ; private key and password for it is:

```bash
TAURI_SIGNING_PRIVATE_KEY=dW50cnVzdGVkIGNvbW1lbnQ6IHJzaWduIGVuY3J5cHRlZCBzZWNyZXQga2V5ClJXUlRZMEl5NlF2SjE3cWNXOVlQQ0JBTlNITEpOUVoyQ3ZuNTdOSkwyNE1NN2RmVWQ1a0FBQkFBQUFBQUFBQUFBQUlBQUFBQU9XOGpTSFNRd0Q4SjNSbm5Oc1E0OThIUGx6SS9lWXI3ZjJxN3BESEh1QTRiQXlkR2E5aG1oK1g0Tk5kcmFzc0IvZFZScEpubnptRkxlbDlUR2R1d1Y5OGRSYUVmUGoxNTFBcHpQZ1dSS2lHWklZVHNkV1Byd1VQSnZCdTZFWlVGOUFNVENBRlgweUU9Cg==
```

```bash
TAURI_SIGNING_PRIVATE_KEY_PASSWORD=pass
```
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Private signing key is published – remove immediately

The Base-64 blob at line 63 is a private Tauri signing key, and the matching password is disclosed at line 67. Anyone can now create a malicious build that verifies as official. Delete the secret, revoke the key, and update the docs to instruct contributors to generate keys locally.

-There is a preset pubkey in tauri.conf.json ; private key and password for it is:
-
-```bash
-TAURI_SIGNING_PRIVATE_KEY=...
-```
-```bash
-TAURI_SIGNING_PRIVATE_KEY_PASSWORD=pass
-```
+# IMPORTANT: Never commit or publish private signing keys.
+# Each contributor MUST generate their own key-pair:
+# ```bash
+# npm run tauri signer generate
+# ```
🧰 Tools
🪛 Gitleaks (8.26.0)

63-63: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)

🤖 Prompt for AI Agents
In CONTRIBUTING.md around lines 60 to 68, remove the published private signing
key and its password to prevent security risks. Replace this section with a
clear instruction for contributors to generate their own key-pair locally using
the command "npm run tauri signer generate". Ensure no private keys or passwords
are included in the repository or documentation.

@ssz2605
Copy link
Contributor Author

ssz2605 commented Jul 4, 2025

I have successfully resolved this issue. If the maintainer finds these changes useful, please consider merging this pull request.

@rahulharpal1603
Copy link
Contributor

@ssz2605, I will review this PR after #440 is merged because of overlapping changes.

@ssz2605
Copy link
Contributor Author

ssz2605 commented Jul 5, 2025

@rahulharpal1603 Sure

@rahulharpal1603
Copy link
Contributor

@rahulharpal1603 Sure

Please pull the latest changes in the main repository into your branch.

@ssz2605 ssz2605 closed this by deleting the head repository Jul 5, 2025
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.

DOC: Add CONTRIBUTING.md and CODE_OF_CONDUCT.md for Contributor Onboarding

2 participants