Skip to content

docs: enhance Support, Features, and Intro pages; improve image SEO, internal linking, clarity, and layout. #115

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

Merged
merged 3 commits into from
Oct 24, 2024

Conversation

tyaga001
Copy link
Contributor

@tyaga001 tyaga001 commented Oct 23, 2024

No description provided.

Copy link
Contributor

coderabbitaidev bot commented Oct 23, 2024

Walkthrough

The pull request introduces significant updates across three documentation files: features.md, pricing.md, and support.md. The changes enhance branding, clarity, and organization of information. Key modifications include title and sidebar label updates in features.md, the addition of a new section on open-source pricing in pricing.md, and structural improvements to the support documentation in support.md. Additionally, image captions have been revised to incorporate the CodeRabbit brand, and formatting adjustments have been made for better readability and emphasis.

Changes

File Change Summary
docs/about/features.md Updated title and sidebar label to "CodeRabbit Features"; reformatted sections for emphasis; modified image captions to include "CodeRabbit"; restructured feedback section.
docs/about/pricing.md Revised introductory section; added "Open Source" section; standardized pricing details formatting; introduced "Plan Comparison" table; updated subscription management section.
docs/about/support.md Streamlined introduction; changed "Community Discord" to "Discord Server"; added tip box for support tickets; reformatted "Customer Responsibilities" into a list; renamed "Email Support" to "Etiquette."

Poem

🐰 In the meadow of CodeRabbit, changes bloom,
Features and pricing, dispelling the gloom.
Support now clearer, a guide to engage,
With bold new captions, we turn a new page.
For open source lovers, the plans are now free,
Hop along, dear friends, come see what can be! 🌼


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

cloudflare-workers-and-pages bot commented Oct 23, 2024

Deploying coderabbit-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: e847df7
Status: ✅  Deploy successful!
Preview URL: https://08cd88c1.coderabbit-docs.pages.dev
Branch Preview URL: https://enhance-support-features-int.coderabbit-docs.pages.dev

View logs

Copy link
Contributor

@coderabbitaidev coderabbitaidev 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: 6

🧹 Outside diff range and nitpick comments (7)
docs/about/support.md (5)

11-13: Remove trailing space after section header.

There's a trailing space after "Discord Server" on line 11.

-## Discord Server 
+## Discord Server
🧰 Tools
🪛 Markdownlint

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


17-19: Add hyphen to compound modifier "bottom-right".

For grammatical correctness, hyphenate the compound modifier.

-For assistance from our support team, click the help icon located in the bottom right corner of the [CodeRabbit UI]
+For assistance from our support team, click the help icon located in the bottom-right corner of the [CodeRabbit UI]
🧰 Tools
🪛 LanguageTool

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)


24-25: Enhance image accessibility with more descriptive alt text.

The current image references could be more descriptive for screen readers.

-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_light.png#gh-light-mode-only)
-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_dark.png#gh-dark-mode-only)
+![Screenshot showing the help icon location in CodeRabbit's bottom-right corner](/img/about/cr_support_help_light.png#gh-light-mode-only)
+![Screenshot showing the help icon location in CodeRabbit's bottom-right corner](/img/about/cr_support_help_dark.png#gh-dark-mode-only)

33-33: Remove trailing space after the introductory text.

There's a trailing space at the end of the line.

-> To ensure efficient resolution of issues, customers are expected to 
+> To ensure efficient resolution of issues, customers are expected to:

Also consider adding a colon to better introduce the list that follows.

🧰 Tools
🪛 Markdownlint

33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-40: Fix formatting and grammar in Etiquette section.

Several improvements needed:

  1. Add blank line before the heading
  2. Add missing comma in the list introduction
+
 ## Etiquette
-Regardless of the method or location through which CodeRabbit provides Support, communication should be professional and respectful. Any communication that is deemed objectionable by CodeRabbit staff is not tolerated. This includes but is not limited to any communication that is abusive or contains profane language. 
+Regardless of the method or location through which CodeRabbit provides Support, communication should be professional and respectful. Any communication that is deemed objectionable by CodeRabbit staff is not tolerated. This includes, but is not limited to, any communication that is abusive or contains profane language. 
🧰 Tools
🪛 LanguageTool

[uncategorized] ~40-~40: Possible missing comma found.
Context: ...it staff is not tolerated. This includes but is not limited to any communication tha...

(AI_HYDRA_LEO_MISSING_COMMA)

🪛 Markdownlint

40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

docs/about/pricing.md (2)

26-26: Use hyphenated compound adjective.

When "Open Source" is used as a compound adjective modifying "projects", it should be hyphenated.

-CodeRabbit Pro is free for all Open Source projects.
+CodeRabbit Pro is free for all Open-Source projects.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)


102-103: Enhance image alt text for better accessibility and SEO.

Consider making the alt text more descriptive to improve accessibility and SEO.

-![Seat Management for CodeRabbit Subscription](/img/about/cr_seat_manage_dark.png#gh-dark-mode-only)
+![CodeRabbit Pro Plan Seat Management Dashboard - Configure and manage subscription seats](/img/about/cr_seat_manage_dark.png#gh-dark-mode-only)
-![Seat Management for CodeRabbit Subscription](/img/about/cr_seat_manage_light.png#gh-light-mode-only)
+![CodeRabbit Pro Plan Seat Management Dashboard - Configure and manage subscription seats](/img/about/cr_seat_manage_light.png#gh-light-mode-only)

-![Free Plan Seat Assignment - CodeRabbit](/img/about/cr_seat_free_dark.png#gh-dark-mode-only)
+![CodeRabbit Free Plan Automatic Seat Assignment Interface - View assigned seats](/img/about/cr_seat_free_dark.png#gh-dark-mode-only)
-![Free Plan Seat Assignment - CodeRabbit](/img/about/cr_seat_free_light.png#gh-light-mode-only)
+![CodeRabbit Free Plan Automatic Seat Assignment Interface - View assigned seats](/img/about/cr_seat_free_light.png#gh-light-mode-only)

Also applies to: 109-110

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 144ed03 and 4a7f29f.

📒 Files selected for processing (4)
  • docs/about/features.md (3 hunks)
  • docs/about/pricing.md (4 hunks)
  • docs/about/support.md (1 hunks)
  • docs/guides/review-instructions.md (1 hunks)
🧰 Additional context used
🪛 Markdownlint
docs/about/features.md

27-27: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


88-88: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

docs/about/pricing.md

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


116-116: null
Files should end with a single newline character

(MD047, single-trailing-newline)

docs/about/support.md

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


23-23: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


28-28: null
Bare URL used

(MD034, no-bare-urls)

docs/guides/review-instructions.md

20-20: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

🪛 LanguageTool
docs/about/features.md

[uncategorized] ~78-~78: You might be missing the article “a” here.
Context: ... For quick fixes, CodeRabbit offers one button solution to commit AI recommende...

(AI_EN_LECTOR_MISSING_DETERMINER_A)

docs/about/pricing.md

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)

docs/about/support.md

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)


[uncategorized] ~40-~40: Possible missing comma found.
Context: ...it staff is not tolerated. This includes but is not limited to any communication tha...

(AI_HYDRA_LEO_MISSING_COMMA)

🔇 Additional comments (10)
docs/about/support.md (1)

7-9: LGTM: Clear and concise introduction.

The welcome message effectively sets expectations for the support process.

docs/about/features.md (5)

2-3: LGTM! Improved title and navigation.

The changes enhance branding while making the navigation more concise.


12-22: LGTM! Enhanced readability and brand consistency.

The bold formatting and updated image captions improve the document's structure and brand visibility.


Line range hint 45-58: LGTM! Improved brand consistency.

The bold formatting of "CodeRabbit" and updated image caption enhance brand visibility.

🧰 Tools
🪛 Markdownlint

27-27: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


62-65: LGTM! Enhanced image caption for SEO.

The updated image caption improves searchability while maintaining clarity.


69-74: LGTM! Added helpful reference link.

The addition of the Mermaid live editor link provides valuable context for users.

docs/about/pricing.md (3)

Line range hint 7-23: LGTM! Clear and well-structured introduction.

The overview effectively communicates the key pricing aspects and value propositions.


48-57: LGTM! Clear pricing and usage limits.

The pricing structure and usage limits are well-presented with appropriate emphasis on key numbers.


76-88: LGTM! Excellent plan comparison presentation.

The table provides a clear, side-by-side comparison of features between Free and Pro plans.

docs/guides/review-instructions.md (1)

20-22: LGTM! Clear explanation of when custom instructions are needed.

The added content effectively clarifies that custom instructions are only necessary for deviating from standard reviews. The blockquote example helps illustrate the point and improves the document's readability.

🧰 Tools
🪛 Markdownlint

20-20: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

Comment on lines +87 to +92
- **CodeRabbit** learns from user chat interactions to gain tribal knowledge on your
repositories and organization.
- **CodeRabbit** will apply and update these learnings
in future reviews.

![Learnings](/img/about/learnings.png)
![Learnings from Interactions - CodeRabbit AI](/img/about/learnings.png)
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

Fix trailing whitespace.

There's a trailing whitespace on line 88 that should be removed.

Apply this diff:

-repositories and organization. 
+repositories and organization.
📝 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
- **CodeRabbit** learns from user chat interactions to gain tribal knowledge on your
repositories and organization.
- **CodeRabbit** will apply and update these learnings
in future reviews.
![Learnings](/img/about/learnings.png)
![Learnings from Interactions - CodeRabbit AI](/img/about/learnings.png)
- **CodeRabbit** learns from user chat interactions to gain tribal knowledge on your
repositories and organization.
- **CodeRabbit** will apply and update these learnings
in future reviews.
![Learnings from Interactions - CodeRabbit AI](/img/about/learnings.png)
🧰 Tools
🪛 Markdownlint

88-88: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

Comment on lines +78 to +79
For quick fixes, **CodeRabbit** offers one button solution to commit AI recommended
changes.
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

Fix grammar in description.

Add the article "a" before "one button solution" for better grammar.

Apply this diff:

-For quick fixes, **CodeRabbit** offers one button solution to commit AI recommended
+For quick fixes, **CodeRabbit** offers a one-button solution to commit AI recommended
📝 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
For quick fixes, **CodeRabbit** offers one button solution to commit AI recommended
changes.
For quick fixes, **CodeRabbit** offers a one-button solution to commit AI recommended
changes.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~78-~78: You might be missing the article “a” here.
Context: ... For quick fixes, CodeRabbit offers one button solution to commit AI recommende...

(AI_EN_LECTOR_MISSING_DETERMINER_A)

Comment on lines +26 to +41
**Code review** feedback is posted as review comments on the lines of the code that
changed for each file.

> Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.

![Review Feedback](/img/about/ReviewFeedback.png)
![CodeRabbit- Code Review Feedback](/img/about/ReviewFeedback.png)

A review status is generated for each commit that is reviewed. It displays the
commit IDs that were reviewed, the files examined and ignored, as well as the
additional comments generated for each review, and so on. Review status is
useful for understanding the auxiliary context of the review.
additional comments generated for each review, and so on.

![Review Status](/img/about/ReviewStatus.png)
:::info
Review status is useful for understanding the auxiliary context of the review.
:::
![CodeRabbit- Review Status](/img/about/ReviewStatus.png)
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

Fix trailing whitespace.

There's a trailing whitespace on line 27 that should be removed.

Apply this diff:

-changed for each file. 
+changed for each file.
📝 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
**Code review** feedback is posted as review comments on the lines of the code that
changed for each file.
> Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.
![Review Feedback](/img/about/ReviewFeedback.png)
![CodeRabbit- Code Review Feedback](/img/about/ReviewFeedback.png)
A review status is generated for each commit that is reviewed. It displays the
commit IDs that were reviewed, the files examined and ignored, as well as the
additional comments generated for each review, and so on. Review status is
useful for understanding the auxiliary context of the review.
additional comments generated for each review, and so on.
![Review Status](/img/about/ReviewStatus.png)
:::info
Review status is useful for understanding the auxiliary context of the review.
:::
![CodeRabbit- Review Status](/img/about/ReviewStatus.png)
**Code review** feedback is posted as review comments on the lines of the code that
changed for each file.
> Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.
![CodeRabbit- Code Review Feedback](/img/about/ReviewFeedback.png)
A review status is generated for each commit that is reviewed. It displays the
commit IDs that were reviewed, the files examined and ignored, as well as the
additional comments generated for each review, and so on.
:::info
Review status is useful for understanding the auxiliary context of the review.
:::
![CodeRabbit- Review Status](/img/about/ReviewStatus.png)
🧰 Tools
🪛 Markdownlint

27-27: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

supported. Thus, pull requests or merge requests created by bots will not be
reviewed.
:::
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

Add newline at end of file.

Add a newline character at the end of the file to comply with markdown best practices.

 reviewed.
:::
+
📝 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
:::
:::
🧰 Tools
🪛 Markdownlint

116-116: null
Files should end with a single newline character

(MD047, single-trailing-newline)

@@ -22,6 +21,18 @@ CodeRabbit.

---

## Open Source
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

Add blank line before heading.

Add a blank line before the "Open Source" heading to improve readability and comply with markdown best practices.

+
## Open Source
📝 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
## Open Source
## Open Source
🧰 Tools
🪛 Markdownlint

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

@@ -17,8 +17,9 @@ This section explains how to add custom code review instructions for the entire
project or specific file paths in your project using glob patterns. Developers
can provide tailored review guidelines based on the file paths. These
instructions are needed only if you want CodeRabbit to follow specific
instructions besides the standard review. For example, you may want to enforce a
style guide by file types or directories.
instructions besides the standard review.
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

Remove trailing space.

There is a trailing space at the end of line 20.

Apply this diff to fix the trailing space:

-instructions besides the standard review. 
+instructions besides the standard review.
📝 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
instructions besides the standard review.
instructions besides the standard review.
🧰 Tools
🪛 Markdownlint

20-20: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

- Number of files reviewed per hour: 150 Files
- Number of reviews per hour (includes incremental reviews): 9
- Number of conversations per hour: 50
- Number of files reviewed per hour: **150 Files**
Copy link
Member

Choose a reason for hiding this comment

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

@dikshant-infracloud can you take a look at this, considering the recent discussion

Copy link
Contributor

Choose a reason for hiding this comment

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

hi @aravindputrevu , changes looks good. I have also updated the values to 150.
We should change the Number of reviews per hour (includes incremental reviews) to 8 to avoid any confusion.

Copy link
Member

Choose a reason for hiding this comment

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

Copy link
Contributor

@dikshant-infracloud dikshant-infracloud left a comment

Choose a reason for hiding this comment

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

hi @aravindputrevu , changes looks good. I have also updated the values to 150.
We should change the Number of reviews per hour (includes incremental reviews) to 8 to avoid any confusion.

- Number of files reviewed per hour: 150 Files
- Number of reviews per hour (includes incremental reviews): 9
- Number of conversations per hour: 50
- Number of files reviewed per hour: **150 Files**
Copy link
Contributor

Choose a reason for hiding this comment

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

hi @aravindputrevu , changes looks good. I have also updated the values to 150.
We should change the Number of reviews per hour (includes incremental reviews) to 8 to avoid any confusion.

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

🧹 Outside diff range and nitpick comments (4)
docs/about/support.md (4)

17-21: Add hyphen for better readability.

Consider adding a hyphen to "bottom-right" for improved readability.

-For assistance from our support team, click the help icon located in the bottom right corner of the [CodeRabbit UI]
+For assistance from our support team, click the help icon located in the bottom-right corner of the [CodeRabbit UI]
🧰 Tools
🪛 LanguageTool

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)


24-25: Enhance image accessibility with more descriptive alt text.

The current alt text could be more descriptive to improve accessibility and SEO.

-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_light.png#gh-light-mode-only)
-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_dark.png#gh-dark-mode-only)
+![Screenshot showing the help icon location in CodeRabbit's interface for opening support tickets](/img/about/cr_support_help_light.png#gh-light-mode-only)
+![Screenshot showing the help icon location in CodeRabbit's interface for opening support tickets](/img/about/cr_support_help_dark.png#gh-dark-mode-only)

31-37: LGTM! Well-structured customer responsibilities.

The numbered list format effectively communicates expectations. Consider removing the trailing space after the introductory line for consistent formatting.

-To ensure efficient resolution of issues, customers are expected to 
+To ensure efficient resolution of issues, customers are expected to:
🧰 Tools
🪛 Markdownlint

33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-42: Address formatting and grammar in Etiquette section.

The content is well-written, but there are minor formatting and grammar improvements needed.

  1. Add a blank line before the "Etiquette" heading
  2. Add a comma in the phrase "includes, but is not limited to"
+
## Etiquette
-Regardless of the method or location through which CodeRabbit provides Support, communication should be professional and respectful. Any communication that is deemed objectionable by CodeRabbit staff is not tolerated. This includes but is not limited to any communication that is abusive or contains profane language.
+Regardless of the method or location through which CodeRabbit provides Support, communication should be professional and respectful. Any communication that is deemed objectionable by CodeRabbit staff is not tolerated. This includes, but is not limited to, any communication that is abusive or contains profane language.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~40-~40: Possible missing comma found.
Context: ...it staff is not tolerated. This includes but is not limited to any communication tha...

(AI_HYDRA_LEO_MISSING_COMMA)

🪛 Markdownlint

40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 4a7f29f and 0287087.

📒 Files selected for processing (1)
  • docs/about/support.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/about/support.md

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)


[uncategorized] ~40-~40: Possible missing comma found.
Context: ...it staff is not tolerated. This includes but is not limited to any communication tha...

(AI_HYDRA_LEO_MISSING_COMMA)

🪛 Markdownlint
docs/about/support.md

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


23-23: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


28-28: null
Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (1)
docs/about/support.md (1)

7-13: LGTM! Clear and concise introduction with accurate Discord information.

The simplified introduction and Discord server section effectively communicate the essential information.

🧰 Tools
🪛 Markdownlint

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

@tyaga001 tyaga001 force-pushed the enhance/support-features-intro-pages branch from 0287087 to 1dd5ff7 Compare October 24, 2024 07:00
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: 3

🧹 Outside diff range and nitpick comments (7)
docs/about/support.md (6)

7-9: Consider removing the response time promise.

The statement "Our support team will respond back as soon as possible" could set unrealistic expectations. Consider removing this or providing specific response time targets based on your service level agreements.

 Welcome to CodeRabbit Support. Please refer to the following sections for
-contacting our support team. Our support team will respond back as soon as
-possible.
+contacting our support team.

11-13: Fix trailing whitespace.

Remove the trailing space after "Discord Server" on line 11 to comply with markdown formatting guidelines.

🧰 Tools
🪛 Markdownlint

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


24-25: Enhance image accessibility with alt text.

The images should have more descriptive alt text for better accessibility.

-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_light.png#gh-light-mode-only)
-![How to Open a Support Ticket-CodeRabbit ](/img/about/cr_support_help_dark.png#gh-dark-mode-only)
+![Screenshot showing how to open a support ticket in CodeRabbit's interface - light mode](/img/about/cr_support_help_light.png#gh-light-mode-only)
+![Screenshot showing how to open a support ticket in CodeRabbit's interface - dark mode](/img/about/cr_support_help_dark.png#gh-dark-mode-only)

18-18: Add hyphen to "bottom-right".

For consistency and clarity, add a hyphen to "bottom-right" in the UI location description.

-For assistance from our support team, click the help icon located in the bottom right corner of the [CodeRabbit UI]
+For assistance from our support team, click the help icon located in the bottom-right corner of the [CodeRabbit UI]
🧰 Tools
🪛 LanguageTool

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)


33-33: Remove trailing whitespace.

Remove the trailing space at the end of line 33.

🧰 Tools
🪛 Markdownlint

33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-42: Add blank line before heading and improve policy clarity.

  1. Add a blank line before the "Etiquette" heading for proper markdown formatting.
  2. Consider making the termination policy more specific.
+
 ## Etiquette
 Regardless of the method or location through which CodeRabbit provides Support, communication should be professional and respectful. Any communication that is deemed objectionable by CodeRabbit staff is not tolerated. This includes but is not limited to any communication that is abusive or contains profane language. 
 
-> CodeRabbit reserves the right to terminate Support Services in the event of any such objectionable communication.
+> CodeRabbit reserves the right to terminate Support Services immediately and without prior notice in the event of any such objectionable communication.
🧰 Tools
🪛 Markdownlint

40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

docs/about/features.md (1)

70-70: Improve Mermaid link description.

The current link text could be more descriptive about its purpose.

Apply this diff:

-[Mermaid Sequence Diagram Example](https://mermaid.live/).
+[Mermaid Live Editor for Sequence Diagrams](https://mermaid.live/).
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 0287087 and 1dd5ff7.

📒 Files selected for processing (3)
  • docs/about/features.md (3 hunks)
  • docs/about/pricing.md (4 hunks)
  • docs/about/support.md (1 hunks)
🧰 Additional context used
🪛 Markdownlint
docs/about/features.md

27-27: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


88-88: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

docs/about/pricing.md

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


116-116: null
Files should end with a single newline character

(MD047, single-trailing-newline)

docs/about/support.md

11-11: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


33-33: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


40-40: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


23-23: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)


39-39: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


28-28: null
Bare URL used

(MD034, no-bare-urls)

🪛 LanguageTool
docs/about/pricing.md

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)

docs/about/support.md

[uncategorized] ~18-~18: Consider adding a hyphen.
Context: ...eam, click the help icon located in the bottom right corner of the [CodeRabbit UI](https://a...

(TOP_LEFT_CORNER)

🔇 Additional comments (6)
docs/about/features.md (4)

2-3: LGTM! Title and sidebar changes improve clarity.

The simplified navigation labels while maintaining brand presence is a good improvement.


27-27: Fix trailing whitespace.

This issue was previously identified and still needs to be addressed.

🧰 Tools
🪛 Markdownlint

27-27: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)


78-79: Fix grammar in description.

This grammar issue was previously identified and still needs to be addressed.


88-88: Fix trailing whitespace.

This issue was previously identified and still needs to be addressed.

🧰 Tools
🪛 Markdownlint

88-88: Expected: 0 or 2; Actual: 1
Trailing spaces

(MD009, no-trailing-spaces)

docs/about/pricing.md (2)

76-88: Great addition of the comparison table!

The table provides a clear, at-a-glance comparison of the plans, making it easier for users to make informed decisions.


112-116: ⚠️ Potential issue

Add newline at end of file.

Add a newline character at the end of the file to comply with markdown best practices.

Apply this diff:

 reviewed.
:::
+
🧰 Tools
🪛 Markdownlint

116-116: null
Files should end with a single newline character

(MD047, single-trailing-newline)

CodeRabbit visualizes the changes occuring in any pull request using
[Mermaid Diagrams](https://mermaid.live/).
**CodeRabbit** visualizes the changes occuring in any pull request using
[Mermaid Sequence Diagram Example](https://mermaid.live/).

![Diagram](/img/about/diagram.png)
Copy link
Contributor

@coderabbitai coderabbitai bot Oct 24, 2024

Choose a reason for hiding this comment

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

⚠️ Potential issue

Update image caption to match branding pattern.

For consistency with other image captions, this should follow the CodeRabbit branding pattern.

Apply this diff:

-![Diagram](/img/about/diagram.png)
+![CodeRabbit- Basic Sequence Diagram](/img/about/diagram.png)
📝 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
![Diagram](/img/about/diagram.png)
![CodeRabbit- Basic Sequence Diagram](/img/about/diagram.png)

Copy link
Member

Choose a reason for hiding this comment

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

@coderabbitai remember to make all markdown image tags to follow SEO guidelines. Like the one listed here. Make this consistent across Docs Pull Requests.

Copy link
Contributor

Choose a reason for hiding this comment

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

@aravindputrevu, understood. I'll ensure all markdown image tags in the documentation follow SEO guidelines and maintain consistency across Docs Pull Requests.

(_/)
(•_•)
/>🌱


✏️ Learnings added
Learnt from: aravindputrevu
PR: coderabbitai/coderabbit-docs#115
File: docs/about/features.md:72-72
Timestamp: 2024-10-24T10:08:27.685Z
Learning: In documentation files, ensure all markdown image tags follow SEO guidelines and maintain consistency across Docs Pull Requests.

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.

Comment on lines +29 to 30
> Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.
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

Improve blockquote clarity and grammar.

The current blockquote about code suggestions could be clearer.

Apply this diff:

-> Code suggestions are given in a Diff format, which either
-be copied or committed within the pull request with a single click.
+> Code suggestions are provided in a Diff format, which can be either
+> copied or committed within the pull request with a single click.
📝 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
> Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.
> Code suggestions are provided in a Diff format, which can be either
> copied or committed within the pull request with a single click.

Comment on lines +24 to +27
## Open Source
:::note
CodeRabbit Pro is free for all Open Source projects.
:::
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

Fix markdown formatting and hyphenation.

Two minor improvements needed:

  1. Add a blank line before the "Open Source" heading
  2. Hyphenate "Open-Source" when used as a compound adjective

Apply this diff:

+
## Open Source
:::note
-CodeRabbit Pro is free for all Open Source projects.
+CodeRabbit Pro is free for all Open-Source projects.
:::
📝 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
## Open Source
:::note
CodeRabbit Pro is free for all Open Source projects.
:::
## Open Source
:::note
CodeRabbit Pro is free for all Open-Source projects.
:::
🧰 Tools
🪛 LanguageTool

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)

🪛 Markdownlint

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

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

🧹 Outside diff range and nitpick comments (1)
docs/about/pricing.md (1)

76-88: Consider enhancing table clarity and consistency.

The comparison table is informative but could be improved:

  1. Replace vague "Limited" descriptions with specific limits where possible
  2. Consider consistent formatting for similar items (e.g., "Included" vs "Yes")

Example improvements:

-| **Private Repos**             | Limited access   | Unlimited access|
+| **Private Repos**             | PR summary only  | Unlimited access|
-| **Hourly Usage Limits**       | Limited          | 150 files/hour, 9 reviews/hour, 50 conversations/hour |
+| **Hourly Usage Limits**       | 50 files/hour, 3 reviews/hour, 10 conversations/hour | 150 files/hour, 9 reviews/hour, 50 conversations/hour |
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 1dd5ff7 and e847df7.

📒 Files selected for processing (1)
  • docs/about/pricing.md (4 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/about/pricing.md

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)

🪛 Markdownlint
docs/about/pricing.md

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)

🔇 Additional comments (4)
docs/about/pricing.md (4)

Line range hint 7-22: LGTM! Clear and well-structured overview section.

The overview effectively communicates key pricing information with well-organized bullet points.


24-33: LGTM! Clear open-source policy.

The section effectively communicates the free offering for open-source projects.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~26-~26: If this is a compound adjective that modifies the following noun, use a hyphen.
Context: ... :::note CodeRabbit Pro is free for all Open Source projects. ::: - Price: $0/month - ...

(EN_COMPOUND_ADJECTIVE_INTERNAL)

🪛 Markdownlint

24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


Line range hint 59-74: LGTM! Clear free plan description.

The section effectively communicates the features and limitations of the free plan.


90-116: LGTM! Well-structured subscription management section.

The section effectively communicates subscription management details with proper image handling for dark/light modes.

Comment on lines +55 to +57
- Number of files reviewed per hour: **150 Files**
- Number of reviews per hour (includes incremental reviews): **8**
- Number of conversations per hour: **50**
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

Fix inconsistent review limit values.

There's a discrepancy in the stated number of reviews per hour:

  • Usage Limits section states "8" reviews per hour
  • Plan Comparison table states "9" reviews per hour

Please update one of these values to ensure consistency.

Also applies to: 86-86

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.

4 participants