Skip to content

Issue #431 resolved : docs: Added CONTRIBUTING.md, updated README.md , and included Code of Conduct.md#450

Merged
rahulharpal1603 merged 4 commits intoAOSSIE-Org:mainfrom
ssz2605:update-documentation
Jul 5, 2025
Merged

Issue #431 resolved : docs: Added CONTRIBUTING.md, updated README.md , and included Code of Conduct.md#450
rahulharpal1603 merged 4 commits intoAOSSIE-Org:mainfrom
ssz2605:update-documentation

Conversation

@ssz2605
Copy link
Contributor

@ssz2605 ssz2605 commented Jul 5, 2025

📚 Summary

This PR improves the project documentation for better onboarding and contribution clarity. The following changes have been made:

  • ✍️ Added CONTRIBUTING.md:
    Includes detailed setup instructions, Git workflow for PRs, and contribution guidelines for new contributors.

  • 📘 Updated README.md:
    Cleaned up previous content and added a reference to the new CONTRIBUTING.md for streamlined navigation.

  • 📄 Added CODE_OF_CONDUCT.md:
    Defines community standards for respectful and inclusive collaboration.


✅ Checklist

  • CONTRIBUTING.md created with setup & PR instructions
  • README.md updated with proper links
  • CODE_OF_CONDUCT.md added for community standards

Looking forward to your feedback! 🙂
closes #431

Summary by CodeRabbit

  • Documentation
    • Added a Code of Conduct outlining community standards and enforcement procedures.
    • Introduced a dedicated contribution guide with setup, testing, build, and troubleshooting instructions.
    • Updated the README to reference the new contribution guide, streamlining setup and contribution information.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jul 5, 2025

Caution

Review failed

The pull request is closed.

Walkthrough

Two new documentation files, CONTRIBUTING.md and CODE_OF_CONDUCT.md, were added to the repository, outlining contribution guidelines and community standards. The README.md was updated to remove setup and contribution instructions, instead directing contributors to the new CONTRIBUTING.md for all related information.

Changes

File(s) Change Summary
CODE_OF_CONDUCT.md Added Contributor Covenant Code of Conduct v2.0, including standards, enforcement, and reporting guidelines.
CONTRIBUTING.md Added detailed setup, testing, building, troubleshooting, and contribution guidelines for the project.
README.md Removed detailed setup and contribution sections; added a pointer to CONTRIBUTING.md for contributors.

Assessment against linked issues

Objective Addressed Explanation
Add CONTRIBUTING.md with setup instructions, guidelines, and contribution process (#431)
Add CODE_OF_CONDUCT.md based on Contributor Covenant for community standards (#431)
Update documentation to improve onboarding and ensure consistent collaboration (#431)

Poem

A rabbit with docs in its paws,
Hopped in to tidy up the cause.
With rules for respect and guides to the code,
Now every new friend can easily load!
The README points the way so clear—
Welcome, contributors, your path is here!
🐇📚✨


📜 Recent review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 9757db7 and 0364b85.

📒 Files selected for processing (1)
  • README.md (2 hunks)

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.

@ssz2605
Copy link
Contributor Author

ssz2605 commented Jul 5, 2025

@rahulharpal1603 Due to some errors I wasn't able to make changes in the existing PR but this PR Is updated with the required changes kindly review.

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: 2

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

58-62: Horizontal rule renders, but consider an H2/H3 header for discoverability

Using --- is technically correct, yet it hides the “Contributing” entry in long READMEs because it’s not a heading. Replacing the rule with a second-level header, e.g. ## Contributing, improves TOC generation in GitHub UI without changing semantics.

CONTRIBUTING.md (2)

16-18: Invalid HTML tag and unnecessary <br>

</br> is not a valid self-closing break tag in HTML/Markdown and breaks some MD renderers. A blank line is enough.

-       </br>

Remove the line or replace with a blank line.


45-52: Minor grammar – missing article “the”

“Set the public key in tauri.conf.json as pubkey and private key and password in Environment Variables …”

Suggested rewrite:

-Set the public key in tauri.conf.json as pubkey and private key and password in Environment Variables as TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD
+Set the public key in `tauri.conf.json` as `pubkey`, and place the private key and its password in the environment variables `TAURI_SIGNING_PRIVATE_KEY` and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD`.
CODE_OF_CONDUCT.md (1)

119-128: Bare URLs lint warnings – wrap in markdown links

markdownlint flags bare URLs. To silence lint and improve readability, wrap them:

-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Contributor Covenant v2.0](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html)

(Apply similarly to the FAQ and translations links.)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between bd3ee6a and 9757db7.

📒 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] ~51-~51: 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)

🪛 markdownlint-cli2 (0.17.2)
CODE_OF_CONDUCT.md

63-63: Bare URL used

(MD034, no-bare-urls)


119-119: Bare URL used

(MD034, no-bare-urls)


127-127: Bare URL used

(MD034, no-bare-urls)


128-128: Bare URL used

(MD034, no-bare-urls)

Comment on lines +51 to +61
Set the public key in tauri.conf.json as pubkey and private key and password in Environment Variables as TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD

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 & password should not be committed

Even if this is a demo key, publishing TAURI_SIGNING_PRIVATE_KEY and its password trains contributors to commit secrets. Move the example to a snippet with obviously bogus values (e.g. BASE64_PRIVATE_KEY_HERE) or link to Tauri docs instead.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~51-~51: 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)

🤖 Prompt for AI Agents
In CONTRIBUTING.md around lines 51 to 61, the private signing key and password
are included as actual values, which encourages committing secrets. Replace the
real base64 private key and password with clearly fake placeholder values like
BASE64_PRIVATE_KEY_HERE and YOUR_PASSWORD_HERE, or remove them entirely and
instead provide a link to the official Tauri documentation for setting these
environment variables securely.

Comment on lines +13 to +14
- Docker Compose Setup: [Guide](./docs/docker-compose/redme.md)
- Setup using Dockerfile
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

Broken link: redme.md typo will 404

./docs/docker-compose/redme.md is misspelled – should be README.md.

-   - Docker Compose Setup: [Guide](./docs/docker-compose/redme.md)
+   - Docker Compose Setup: [Guide](./docs/docker-compose/README.md)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- Docker Compose Setup: [Guide](./docs/docker-compose/redme.md)
- Setup using Dockerfile
- Docker Compose Setup: [Guide](./docs/docker-compose/README.md)
- Setup using Dockerfile
🤖 Prompt for AI Agents
In CONTRIBUTING.md around lines 13 to 14, the link to the Docker Compose Setup
guide has a typo in the filename `redme.md`. Correct the filename in the link to
`README.md` to fix the broken link and prevent 404 errors.

@ssz2605
Copy link
Contributor Author

ssz2605 commented Jul 5, 2025

also I haven't modified anything as you suggested earlier have only moved the content from README to CONTRIBUTING.md

@rahulharpal1603
Copy link
Contributor

@ssz2605 Thank you the PR!

@rahulharpal1603 rahulharpal1603 merged commit de67f71 into AOSSIE-Org:main Jul 5, 2025
1 check was pending
@ssz2605
Copy link
Contributor Author

ssz2605 commented Jul 6, 2025

@rahulharpal1603 Thanks! Looking forward to more contributions.

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