Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create CONTRIBUTING.md #136

Merged
merged 5 commits into from
Dec 20, 2024
Merged

Conversation

cp-radhika-s
Copy link
Member

@cp-radhika-s cp-radhika-s commented Dec 19, 2024

Changelog

  • Adding a doc for contribution guideline

Summary by CodeRabbit

  • New Features
    • Introduced a "Contributing" section in the documentation, providing guidelines for contributions.
    • Updated the README to welcome contributions and provide a link to the Contributor Guide.
    • Enhanced clarity and structure of contribution processes for better accessibility.

Copy link

coderabbitai bot commented Dec 19, 2024

Walkthrough

The pull request introduces a comprehensive "Contributing" section in the CONTRIBUTING.md file, providing clear guidelines for potential project contributors. The documentation outlines processes for feature requests, bug reporting, and support inquiries, including expectations for issue submission and follow-up procedures. Additionally, the README.md file has been updated to encourage contributions and direct users to the new contributor guidelines, replacing a previous statement that discouraged participation.

Changes

File Change Summary
CONTRIBUTING.md Added new comprehensive "Contributing" section with guidelines for feature requests, bug reporting, support requests, and project setup.
README.md Revised contribution message to encourage participation and link to the Contributor Guide; minor formatting adjustments made.

Sequence Diagram

sequenceDiagram
    participant Contributor
    participant GitHub
    participant ProjectTeam

    Contributor->>GitHub: Open Issue/Feature Request
    GitHub->>ProjectTeam: Notify of New Submission
    ProjectTeam->>ProjectTeam: Review and Label Issue
    ProjectTeam->>Contributor: Request Additional Information (if needed)
    Contributor-->>ProjectTeam: Provide Details
    ProjectTeam->>ProjectTeam: Evaluate Submission
    ProjectTeam->>GitHub: Update Issue Status
Loading

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

‼️ IMPORTANT
Auto-reply has been disabled for this repository in the CodeRabbit settings. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

  • 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 generate unit testing code for this file.
    • @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 generate unit testing code.
    • @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.

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. (Beta)
  • @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 or 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

@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 (6)
CONTRIBUTING.md (6)

2-2: Fix double punctuation mark

Remove the period after the exclamation mark.

-Thank you so much for your interest in contributing!. All types of contributions are encouraged and valued.
+Thank you so much for your interest in contributing! All types of contributions are encouraged and valued.
🧰 Tools
🪛 LanguageTool

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


19-19: Use inline link formatting for URLs

Convert the bare URL to proper Markdown link syntax.

-* Open an Issue at https://github.com/canopas/group-track-android/issues
+* Open an Issue at [our issues page](https://github.com/canopas/group-track-android/issues)
🧰 Tools
🪛 Markdownlint (0.37.0)

19-19: null
Bare URL used

(MD034, no-bare-urls)


36-36: Improve clarity and formatting

  1. Format the URL as a proper Markdown link
  2. Consider using "reproduction" instead of "repro" for clarity
-* Open an Issue at https://github.com/canopas/group-track-android/issues
+* Open an Issue at [our issues page](https://github.com/canopas/group-track-android/issues)

-* A team member will try to reproduce the issue with your provided steps. If there are no repro steps or no obvious way to reproduce the issue
+* A team member will try to reproduce the issue with your provided steps. If there are no reproduction steps or no obvious way to reproduce the issue

Also applies to: 43-43

🧰 Tools
🪛 Markdownlint (0.37.0)

36-36: null
Bare URL used

(MD034, no-bare-urls)


48-48: Fix heading indentation

Remove the extra space before the heading.

- ## Request Support
+## Request Support
🧰 Tools
🪛 Markdownlint (0.37.0)

48-48: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


64-64: Improve language professionalism and link accuracy

  1. Replace informal language with more professional alternatives
  2. Add proper link to requirements section
-So you wanna contribute some code!
+So you want to contribute some code!

-Follow the [requirements](https://github.com/canopas/group-track-android?tab=readme-ov-file#requirements)
+Follow the [project requirements](../README.md#requirements)

Also applies to: 68-68

🧰 Tools
🪛 LanguageTool

[style] ~64-~64: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


1-71: Overall document structure feedback

The document provides a good foundation for contribution guidelines, but needs some improvements:

  1. Add missing referenced sections:
    • Label issues process
    • Code contribution guidelines
  2. Consider adding sections for:
    • Pull request process
    • Code review expectations
    • Coding standards
    • Commit message guidelines

Would you like me to help draft any of these additional sections?

🧰 Tools
🪛 LanguageTool

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


[style] ~44-~44: As a shorter alternative for ‘able to’, consider using “can”.
Context: ...ntil they are reproduced. * If the team is able to reproduce the issue, it will be marked ...

(BE_ABLE_TO)


[style] ~45-~45: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...l be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (onc...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[uncategorized] ~46-~46: When a number forms part of an adjectival compound, use a hyphen.
Context: ...d immediacy and severity, even past the 30 day deadline. ## Request Support If you ...

(MISSING_HYPHEN)


[style] ~64-~64: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


[uncategorized] ~66-~66: Use a comma before ‘or’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...one it before. If this seems like a lot or you aren't able to do all this setup, y...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~68-~68: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...ov-file#requirements) to run the project and you should be ready to go!

(COMMA_COMPOUND_SENTENCE)


[style] ~68-~68: Using many exclamation marks might seem excessive (in this case: 6 exclamation marks for a text that’s 4200 characters long)
Context: ...he project and you should be ready to go!

(EN_EXCESSIVE_EXCLAMATION)

🪛 Markdownlint (0.37.0)

48-48: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


19-19: null
Bare URL used

(MD034, no-bare-urls)


36-36: null
Bare URL used

(MD034, no-bare-urls)


52-52: null
Bare URL used

(MD034, no-bare-urls)


25-25: null
Link fragments should be valid

(MD051, link-fragments)


27-27: null
Link fragments should be valid

(MD051, link-fragments)


42-42: null
Link fragments should be valid

(MD051, link-fragments)


45-45: null
Link fragments should be valid

(MD051, link-fragments)


58-58: null
Link fragments should be valid

(MD051, link-fragments)


60-60: null
Link fragments should be valid

(MD051, link-fragments)


66-66: null
Link fragments should be valid

(MD051, link-fragments)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between e5b3fd9 and 95ac952.

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

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


[style] ~44-~44: As a shorter alternative for ‘able to’, consider using “can”.
Context: ...ntil they are reproduced. * If the team is able to reproduce the issue, it will be marked ...

(BE_ABLE_TO)


[style] ~45-~45: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...l be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (onc...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[uncategorized] ~46-~46: When a number forms part of an adjectival compound, use a hyphen.
Context: ...d immediacy and severity, even past the 30 day deadline. ## Request Support If you ...

(MISSING_HYPHEN)


[style] ~64-~64: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


[uncategorized] ~66-~66: Use a comma before ‘or’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...one it before. If this seems like a lot or you aren't able to do all this setup, y...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~68-~68: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...ov-file#requirements) to run the project and you should be ready to go!

(COMMA_COMPOUND_SENTENCE)


[style] ~68-~68: Using many exclamation marks might seem excessive (in this case: 6 exclamation marks for a text that’s 4200 characters long)
Context: ...he project and you should be ready to go!

(EN_EXCESSIVE_EXCLAMATION)

🪛 Markdownlint (0.37.0)
CONTRIBUTING.md

48-48: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


19-19: null
Bare URL used

(MD034, no-bare-urls)


36-36: null
Bare URL used

(MD034, no-bare-urls)


52-52: null
Bare URL used

(MD034, no-bare-urls)


25-25: null
Link fragments should be valid

(MD051, link-fragments)


27-27: null
Link fragments should be valid

(MD051, link-fragments)


42-42: null
Link fragments should be valid

(MD051, link-fragments)


45-45: null
Link fragments should be valid

(MD051, link-fragments)


58-58: null
Link fragments should be valid

(MD051, link-fragments)


60-60: null
Link fragments should be valid

(MD051, link-fragments)


66-66: null
Link fragments should be valid

(MD051, link-fragments)

🔇 Additional comments (1)
CONTRIBUTING.md (1)

11-13: ⚠️ Potential issue

Update anchor links to match heading IDs

The quicklinks section contains references to non-existent anchor IDs. GitHub automatically generates heading IDs by converting to lowercase and replacing spaces with hyphens.

-  * [Request a Feature](#request-a-feature)
-  * [Report an Error or Bug](#report-an-error-or-bug)
-  * [Request Support](#request-support)
+  * [Request a Feature](#request-a-feature)
+  * [Report an Error or Bug](#report-an-error-or-bug)
+  * [Request Support](#request-support)

Likely invalid or redundant comment.

CONTRIBUTING.md Outdated Show resolved Hide resolved
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: 0

🧹 Nitpick comments (7)
CONTRIBUTING.md (7)

2-2: Fix double punctuation

Remove the redundant punctuation mark.

-Thank you so much for your interest in contributing!. All types of contributions are encouraged and valued.
+Thank you so much for your interest in contributing! All types of contributions are encouraged and valued.
🧰 Tools
🪛 LanguageTool

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


28-28: Use markdown link syntax

Convert the bare URL to a proper markdown link for better formatting.

-* Open an Issue at https://github.com/canopas/group-track-android/issues
+* Open an Issue at [GitHub Issues](https://github.com/canopas/group-track-android/issues)
🧰 Tools
🪛 Markdownlint (0.37.0)

28-28: null
Bare URL used

(MD034, no-bare-urls)


55-55: Add hyphen in compound adjective

Add a hyphen between "30" and "day" when used as a compound adjective.

-even past the 30 day deadline.
+even past the 30-day deadline.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~55-~55: When a number forms part of an adjectival compound, use a hyphen.
Context: ...d immediacy and severity, even past the 30 day deadline. ## Request Support If you ...

(MISSING_HYPHEN)


73-73: Use formal language in documentation

Replace informal language with more professional alternatives.

-So you wanna contribute some code!
+So you want to contribute some code!
🧰 Tools
🪛 LanguageTool

[style] ~73-~73: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


127-140: Fix table formatting and add missing cells

The table has inconsistent formatting and missing cells. Please:

  1. Remove trailing pipes
  2. Add missing cells in rows
  3. Ensure consistent column count

Example fix for one row:

-`critical` | Added to `bug` issues if the problem described makes the code completely unusable in a common situation. |
+`critical` | Added to `bug` issues if the problem described makes the code completely unusable in a common situation. | High priority for maintainers
🧰 Tools
🪛 LanguageTool

[style] ~132-~132: ‘exact same’ might be wordy. Consider a shorter alternative.
Context: ...dded to issues or PRs that refer to the exact same issue as another one that's been previo...

(EN_WORDINESS_PREMIUM_EXACT_SAME)


[style] ~135-~135: Consider using “who” when you are referring to a person instead of an object.
Context: ...bmitter should @mention the team member that applied the label once the PR is comple...

(THAT_WHO)


[style] ~140-~140: This phrase is redundant. Consider using “outside”.
Context: ...h the project or are otherwise entirely outside of its scope/sphere of influence or mainta...

(OUTSIDE_OF)


[uncategorized] ~140-~140: Possible missing comma found.
Context: ...entirely outside of its scope/sphere of influence or maintainer decide to pass on an othe...

(AI_HYDRA_LEO_MISSING_COMMA)


[style] ~140-~140: Consider shortening this phrase to just “whether”, or rephrase the sentence to avoid “as to”.
Context: ...decision ultimately falls on committers as to whether to accept something or not. ## Clean U...

(WHETHER)

🪛 Markdownlint (0.37.0)

130-130: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


133-133: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


136-136: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


137-137: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


139-139: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


130-130: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


133-133: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


136-136: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


137-137: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


139-139: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


159-168: Use consistent heading style and list formatting

Convert the setext-style heading to ATX-style and use consistent list markers.

-Merge Pull Requests 
-----------------------------------------------------------
+## Merge Pull Requests

-  - The change is easier to understand as a series of focused commits.
-  - Contributor is using an e-mail address other than the primary GitHub address
+  * The change is easier to understand as a series of focused commits.
+  * Contributor is using an e-mail address other than the primary GitHub address
🧰 Tools
🪛 LanguageTool

[uncategorized] ~162-~162: Possible missing comma found.
Context: ...your-commits) by default for individual contributions unless requested by the PR author. Do...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~167-~167: Possible missing article found.
Context: ...and as a series of focused commits. - Contributor is using an e-mail address other than t...

(AI_HYDRA_LEO_MISSING_THE)

🪛 Markdownlint (0.37.0)

159-159: Expected: atx; Actual: setext
Heading style

(MD003, heading-style)


166-166: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


167-167: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


1-168: Overall document structure improvements needed

While the content is comprehensive, there are several structural improvements needed:

  1. Ensure all referenced sections exist and are properly linked
  2. Maintain consistent formatting throughout the document:
    • Use ATX-style headings
    • Use consistent list markers (asterisks)
    • Format URLs as markdown links
    • Fix table formatting
  3. Use formal language consistently

The document provides valuable guidelines but needs these refinements for better readability and maintainability.

🧰 Tools
🪛 LanguageTool

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


[style] ~53-~53: As a shorter alternative for ‘able to’, consider using “can”.
Context: ...ntil they are reproduced. * If the team is able to reproduce the issue, it will be marked ...

(BE_ABLE_TO)


[style] ~54-~54: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...l be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (onc...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[uncategorized] ~55-~55: When a number forms part of an adjectival compound, use a hyphen.
Context: ...d immediacy and severity, even past the 30 day deadline. ## Request Support If you ...

(MISSING_HYPHEN)


[style] ~73-~73: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


[uncategorized] ~75-~75: Use a comma before ‘or’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...one it before. If this seems like a lot or you aren't able to do all this setup, y...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~77-~77: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...ov-file#requirements) to run the project and you should be ready to go! ## Contrib...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~88-~88: You might be missing the article “a” here.
Context: ...contribution works as expected. * Write clear, concise commit message(s). * Go to htt...

(AI_EN_LECTOR_MISSING_DETERMINER_A)


[uncategorized] ~103-~103: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... not uncommon for most of the issues on open source projects to be support-related question...

(EN_COMPOUND_ADJECTIVE_INTERNAL)


[style] ~106-~106: Consider a shorter alternative to avoid wordiness.
Context: ...ention a maintainer so they can do it. In order to help other folks out with their questio...

(IN_ORDER_TO_PREMIUM)


[style] ~125-~125: ‘each and every’ might be wordy. Consider a shorter alternative.
Context: ...next one: don't feel obligated to label each and every issue yourself! Label | Apply When | N...

(EN_WORDINESS_PREMIUM_EACH_AND_EVERY)


[style] ~132-~132: ‘exact same’ might be wordy. Consider a shorter alternative.
Context: ...dded to issues or PRs that refer to the exact same issue as another one that's been previo...

(EN_WORDINESS_PREMIUM_EXACT_SAME)


[style] ~135-~135: Consider using “who” when you are referring to a person instead of an object.
Context: ...bmitter should @mention the team member that applied the label once the PR is comple...

(THAT_WHO)


[style] ~140-~140: This phrase is redundant. Consider using “outside”.
Context: ...h the project or are otherwise entirely outside of its scope/sphere of influence or mainta...

(OUTSIDE_OF)


[uncategorized] ~140-~140: Possible missing comma found.
Context: ...entirely outside of its scope/sphere of influence or maintainer decide to pass on an othe...

(AI_HYDRA_LEO_MISSING_COMMA)


[style] ~140-~140: Consider shortening this phrase to just “whether”, or rephrase the sentence to avoid “as to”.
Context: ...decision ultimately falls on committers as to whether to accept something or not. ## Clean U...

(WHETHER)


[style] ~144-~144: You have already used this phrasing in nearby sentences. Consider replacing it to add variety to your writing.
Context: ...after a while. Maybe they're abandoned. Maybe the team will just plain not have time ...

(REP_MAYBE)


[style] ~151-~151: Consider removing “of” to be more concise
Context: ... oldest to newest*, and close them if all of the following are true: * not opened by...

(ALL_OF_THE)


[uncategorized] ~162-~162: Possible missing comma found.
Context: ...your-commits) by default for individual contributions unless requested by the PR author. Do...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~167-~167: Possible missing article found.
Context: ...and as a series of focused commits. - Contributor is using an e-mail address other than t...

(AI_HYDRA_LEO_MISSING_THE)

🪛 Markdownlint (0.37.0)

159-159: Expected: atx; Actual: setext
Heading style

(MD003, heading-style)


166-166: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


167-167: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


57-57: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


28-28: null
Bare URL used

(MD034, no-bare-urls)


45-45: null
Bare URL used

(MD034, no-bare-urls)


61-61: null
Bare URL used

(MD034, no-bare-urls)


89-89: null
Bare URL used

(MD034, no-bare-urls)


130-130: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


133-133: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


136-136: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


137-137: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


139-139: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


130-130: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


133-133: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


136-136: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


137-137: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


139-139: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 95ac952 and ecfcb64.

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

[formatting] ~2-~2: These punctuation marks differ from each other. Use only one if you are ending a sentence.
Context: ...o much for your interest in contributing!. All types of contributions are encourag...

(DOUBLE_PUNCTUATION_PREMIUM)


[style] ~53-~53: As a shorter alternative for ‘able to’, consider using “can”.
Context: ...ntil they are reproduced. * If the team is able to reproduce the issue, it will be marked ...

(BE_ABLE_TO)


[style] ~54-~54: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...l be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (onc...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[uncategorized] ~55-~55: When a number forms part of an adjectival compound, use a hyphen.
Context: ...d immediacy and severity, even past the 30 day deadline. ## Request Support If you ...

(MISSING_HYPHEN)


[style] ~73-~73: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code! That's great! Thi...

(WANNA)


[uncategorized] ~75-~75: Use a comma before ‘or’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...one it before. If this seems like a lot or you aren't able to do all this setup, y...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~77-~77: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...ov-file#requirements) to run the project and you should be ready to go! ## Contrib...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~88-~88: You might be missing the article “a” here.
Context: ...contribution works as expected. * Write clear, concise commit message(s). * Go to htt...

(AI_EN_LECTOR_MISSING_DETERMINER_A)


[uncategorized] ~103-~103: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... not uncommon for most of the issues on open source projects to be support-related question...

(EN_COMPOUND_ADJECTIVE_INTERNAL)


[style] ~106-~106: Consider a shorter alternative to avoid wordiness.
Context: ...ention a maintainer so they can do it. In order to help other folks out with their questio...

(IN_ORDER_TO_PREMIUM)


[style] ~125-~125: ‘each and every’ might be wordy. Consider a shorter alternative.
Context: ...next one: don't feel obligated to label each and every issue yourself! Label | Apply When | N...

(EN_WORDINESS_PREMIUM_EACH_AND_EVERY)


[style] ~132-~132: ‘exact same’ might be wordy. Consider a shorter alternative.
Context: ...dded to issues or PRs that refer to the exact same issue as another one that's been previo...

(EN_WORDINESS_PREMIUM_EXACT_SAME)


[style] ~135-~135: Consider using “who” when you are referring to a person instead of an object.
Context: ...bmitter should @mention the team member that applied the label once the PR is comple...

(THAT_WHO)


[style] ~140-~140: This phrase is redundant. Consider using “outside”.
Context: ...h the project or are otherwise entirely outside of its scope/sphere of influence or mainta...

(OUTSIDE_OF)


[uncategorized] ~140-~140: Possible missing comma found.
Context: ...entirely outside of its scope/sphere of influence or maintainer decide to pass on an othe...

(AI_HYDRA_LEO_MISSING_COMMA)


[style] ~140-~140: Consider shortening this phrase to just “whether”, or rephrase the sentence to avoid “as to”.
Context: ...decision ultimately falls on committers as to whether to accept something or not. ## Clean U...

(WHETHER)


[style] ~144-~144: You have already used this phrasing in nearby sentences. Consider replacing it to add variety to your writing.
Context: ...after a while. Maybe they're abandoned. Maybe the team will just plain not have time ...

(REP_MAYBE)


[style] ~151-~151: Consider removing “of” to be more concise
Context: ... oldest to newest*, and close them if all of the following are true: * not opened by...

(ALL_OF_THE)


[uncategorized] ~162-~162: Possible missing comma found.
Context: ...your-commits) by default for individual contributions unless requested by the PR author. Do...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~167-~167: Possible missing article found.
Context: ...and as a series of focused commits. - Contributor is using an e-mail address other than t...

(AI_HYDRA_LEO_MISSING_THE)

🪛 Markdownlint (0.37.0)
CONTRIBUTING.md

159-159: Expected: atx; Actual: setext
Heading style

(MD003, heading-style)


166-166: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


167-167: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


57-57: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


28-28: null
Bare URL used

(MD034, no-bare-urls)


45-45: null
Bare URL used

(MD034, no-bare-urls)


61-61: null
Bare URL used

(MD034, no-bare-urls)


89-89: null
Bare URL used

(MD034, no-bare-urls)


130-130: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


133-133: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


136-136: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


137-137: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


139-139: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


130-130: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


133-133: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


136-136: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


137-137: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


139-139: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)

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

🧹 Nitpick comments (3)
CONTRIBUTING.md (3)

73-73: Use more professional language

Consider using more formal language in the documentation.

-So you wanna contribute some code? That's great!
+Interested in contributing code? That's great!
🧰 Tools
🪛 LanguageTool

[style] ~73-~73: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code? That's great! Thi...

(WANNA)


103-103: Use more professional language

Consider using more formal language in the documentation.

-Helping out other users with their questions is an awesome way of contributing to any community.
+Helping other users with their questions is an excellent way of contributing to any community.
🧰 Tools
🪛 LanguageTool

[style] ~103-~103: Consider using a more formal and expressive alternative to ‘awesome’.
Context: ...out other users with their questions is an awesome way of contributing to any community. I...

(AWESOME)


159-161: Use consistent heading style

Use ATX-style headings (with #) throughout the document for consistency.

-Merge Pull Requests 
-----------------------------------------------------------
+## Merge Pull Requests
🧰 Tools
🪛 Markdownlint (0.37.0)

159-159: Expected: atx; Actual: setext
Heading style

(MD003, heading-style)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 346efea and 6b0f878.

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

[style] ~54-~54: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...l be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (onc...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~73-~73: The word ‘wanna’ is informal.
Context: ...already made. ## Project Setup So you wanna contribute some code? That's great! Thi...

(WANNA)


[uncategorized] ~75-~75: Use a comma before ‘or’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...one it before. If this seems like a lot or you aren't able to do all this setup, y...

(COMMA_COMPOUND_SENTENCE)


[uncategorized] ~77-~77: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...ov-file#requirements) to run the project and you should be ready to go! ## Contrib...

(COMMA_COMPOUND_SENTENCE)


[style] ~103-~103: Consider using a more formal and expressive alternative to ‘awesome’.
Context: ...out other users with their questions is an awesome way of contributing to any community. I...

(AWESOME)


[style] ~140-~140: This phrase is redundant. Consider using “outside”.
Context: ...h the project or are otherwise entirely outside of its scope/sphere of influence or the ma...

(OUTSIDE_OF)


[style] ~140-~140: Consider shortening this phrase to just “whether”, or rephrase the sentence to avoid “as to”.
Context: ...decision ultimately falls on committers as to whether to accept something or not. ## Clean U...

(WHETHER)


[style] ~144-~144: You have already used this phrasing in nearby sentences. Consider replacing it to add variety to your writing.
Context: ...after a while. Maybe they're abandoned. Maybe the team will just not have time to add...

(REP_MAYBE)


[style] ~151-~151: Consider removing “of” to be more concise
Context: ... oldest to newest*, and close them if all of the following are true: * not opened by...

(ALL_OF_THE)


[uncategorized] ~167-~167: Possible missing article found.
Context: ...and as a series of focused commits. - Contributor is using an e-mail address other than t...

(AI_HYDRA_LEO_MISSING_THE)

🪛 Markdownlint (0.37.0)
CONTRIBUTING.md

159-159: Expected: atx; Actual: setext
Heading style

(MD003, heading-style)


166-166: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


167-167: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


57-57: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


28-28: null
Bare URL used

(MD034, no-bare-urls)


45-45: null
Bare URL used

(MD034, no-bare-urls)


61-61: null
Bare URL used

(MD034, no-bare-urls)


89-89: null
Bare URL used

(MD034, no-bare-urls)


130-130: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


133-133: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


136-136: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


137-137: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


139-139: Expected: no_leading_or_trailing; Actual: trailing_only; Unexpected trailing pipe
Table pipe style

(MD055, table-pipe-style)


130-130: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


133-133: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


136-136: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


137-137: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)


139-139: Expected: 3; Actual: 2; Too few cells, row will be missing data
Table column count

(MD056, table-column-count)

🔇 Additional comments (1)
CONTRIBUTING.md (1)

10-21: Fix broken section links in Quick Links

The following sections are referenced but don't exist in the document with matching heading IDs:

  • #label-issues
  • #contribute-code

Please ensure all section links are properly connected to their corresponding headings.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
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

🧹 Nitpick comments (4)
CONTRIBUTING.md (4)

6-6: Enhance link accessibility

Consider making the link text more descriptive for better accessibility.

-Similarly, if you support a particular feature request, please let us know by commenting on the issue or [subscribing](https://help.github.com/articles/subscribing-to-conversations/) to the issue.
+Similarly, if you support a particular feature request, please let us know by commenting on the issue or [subscribing to the discussion](https://help.github.com/articles/subscribing-to-conversations/).

8-8: Enhance bug report guidelines

Consider adding more specific examples of what information to include in bug reports.

-If you are reporting a bug, please help speed up problem diagnosis by providing as much information as possible. Ideally, that would include a small sample project (or gist) that reproduces the problem.
+If you are reporting a bug, please help speed up problem diagnosis by providing as much information as possible:
+- Steps to reproduce the issue
+- Expected behavior vs actual behavior
+- Android version and device information
+- Relevant logs or error messages
+- Ideally, a small sample project (or gist) that reproduces the problem

31-32: Fix license section formatting

The license section has formatting issues.

- ## License
- By contributing to GroupTrack, you agree that your contributions will be licensed under its Apache License, Version 2.0. See LICENSE file for details.
+## License
+By contributing to GroupTrack, you agree that your contributions will be licensed under its Apache License, Version 2.0. See [LICENSE](LICENSE) file for details.
🧰 Tools
🪛 Markdownlint (0.37.0)

31-31: null
Headings must start at the beginning of the line

(MD023, heading-start-left)


1-32: Consider adding a table of contents

For better navigation, consider adding a table of contents at the beginning of the document. This would be especially helpful as the guidelines grow.

+# Contributing
+
+## Table of Contents
+- [Filing Issues](#filing-issues)
+- [Contributing Code](#contributing-code)
+- [Labels](#labels)
+- [License](#license)
+
 # Contributing
🧰 Tools
🪛 LanguageTool

[duplication] ~17-~17: Possible typo: you repeated a word
Context: ...s 4. Make sure your code lints. ## Labels Labels on issues are managed by contributors, ...

(ENGLISH_WORD_REPEAT_RULE)


[style] ~24-~24: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ...producible**: has enough information to very easily reproduce, mostly in the form of a smal...

(EN_WEAK_ADJECTIVE)


[typographical] ~25-~25: The word “otherwise” is an adverb that can’t be used like a conjunction, and therefore needs to be separated from the sentence.
Context: ... code to be able to reproduce and debug locally, otherwise there's not much we can do * **duplica...

(THUS_SENTENCE)

🪛 Markdownlint (0.37.0)

20-20: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


21-21: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


22-22: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


23-23: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


24-24: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


25-25: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


26-26: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


27-27: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


28-28: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


29-29: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


31-31: null
Headings must start at the beginning of the line

(MD023, heading-start-left)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 6b0f878 and 53109d9.

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

[duplication] ~17-~17: Possible typo: you repeated a word
Context: ...s 4. Make sure your code lints. ## Labels Labels on issues are managed by contributors, ...

(ENGLISH_WORD_REPEAT_RULE)


[style] ~24-~24: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ...producible**: has enough information to very easily reproduce, mostly in the form of a smal...

(EN_WEAK_ADJECTIVE)


[typographical] ~25-~25: The word “otherwise” is an adverb that can’t be used like a conjunction, and therefore needs to be separated from the sentence.
Context: ... code to be able to reproduce and debug locally, otherwise there's not much we can do * **duplica...

(THUS_SENTENCE)

🪛 Markdownlint (0.37.0)
CONTRIBUTING.md

20-20: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


21-21: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


22-22: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


23-23: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


24-24: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


25-25: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


26-26: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


27-27: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


28-28: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


29-29: Expected: 0; Actual: 1
Unordered list indentation

(MD007, ul-indent)


31-31: null
Headings must start at the beginning of the line

(MD023, heading-start-left)

CONTRIBUTING.md Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
@cp-radhika-s cp-radhika-s self-assigned this Dec 20, 2024
@cp-radhika-s cp-radhika-s merged commit 9fe91da into main Dec 20, 2024
2 checks passed
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