doc fixes (#33)

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: Gur singh <[email protected]>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: 3 people

docs/faq/faq.md

@@ -4,81 +4,109 @@ sidebar_label: FAQs
 description: Frequently asked questions about CodeRabbit.
 ---
 
-#### **1. How accurate is CodeRabbit's review?**
+#### How accurate is CodeRabbit's review?
 
 Early adoption results for CodeRabbit have been highly promising, demonstrating
 significant accuracy in code reviews. However, it's crucial to understand that
 AI is an evolving field, and absolute 100% accuracy can't be guaranteed. Our
-technology is continuously learning and improving, aiming for the highest
-possible accuracy in reviews.
+technology is continuously improving, aiming for the highest possible accuracy
+in reviews.
 
-#### **2. Which programming languages does CodeRabbit support?**
+#### Which programming languages does CodeRabbit support?
 
 CodeRabbit is designed to work with all programming languages. However, the
-proficiency of our AI models might vary between languages, which could slightly
-affect the accuracy of the review.
+proficiency of our AI models might vary between languages based on their
+popularity and the public availability of training data.
 
-#### **3. Does CodeRabbit store my code ?**
+#### Does CodeRabbit store my code?
 
-We do not store any source code. The code collected at the time of the review is disposed of as soon as the review is complete. During the review, there is complete data isolation for the code being reviewed, and no one from CodeRabbit or outside has access to the code.
+We do not store your code. The code collected at the time of the review is
+disposed off as soon as the review is complete. During the review, there is
+complete data isolation of the code being reviewed, and no one from CodeRabbit
+or outside has access to the code.
 
-#### **4. Does CodeRabbit use my proprietary code for training language models?**
+#### Does CodeRabbit use my proprietary code for training language models?
 
-We train our system only using open source projects. CodeRabbit never uses the proprietary 
-code on private repositories for training purposes.
+We train our system only using publicly available datasets. CodeRabbit never
+uses the proprietary code from private repositories for training purposes.
 
-#### **5. What Large Language Models does CodeRabbit use?**
+#### Can I switch between different organizations on CodeRabbit?
+
+Yes, you can switch between different organizations on CodeRabbit. To do so,
+click on the organization name in the top-right corner of the CodeRabbit UI.
+
+![Switch Organizations](./images/cr_support_orgs_light.png#gh-light-mode-only)
+![Switch Organizations](./images/cr_support_orgs_dark.png#gh-dark-mode-only)
+
+#### Can CodeRabbit subscription be used across multiple organizations?
+
+Subscription seats are tied to the specific GitHub/GitLab organization under
+which they are purchased and cannot be used under another organization.
+
+#### Can CodeRabbit review my existing PRs after integrating it?
+
+CodeRabbit would by default only review new PRs or existing PRs which have a new
+commit after the app is installed. You can, however, use the
+`@coderabbitai review` command on the PR to trigger a review of existing PRs.
+
+#### Who can add the repositories on CodeRabbit?
+
+You need to be a GitHub/GitLab admin to add the repositories.
+
+#### Do I need my own OpenAI key with CodeRabbit Pro?
+
+OpenAI cost is included as part of the subscription. You don't need to have your
+own OpenAI key.
+
+#### What Large Language Models does CodeRabbit use?
 
 CodeRabbit currently utilizes OpenAI's `gpt-4-turbo` and `gpt-3.5-turbo`. We're
 researching and testing upcoming LLMs to ensure we're offering the most precise
 reviews possible.
 
-#### **6. Can I customize CodeRabbit?**
+#### Can I customize CodeRabbit?
 
 Reviews are customizable. For information, check out our
-[Get Started page](../get-started/signup.md).
+[Customization](../guides/review-instructions.md) guide.
 
-#### **7. Can I choose a language other than English for the reviews?**
+#### Can I choose a language other than English for the reviews?
 
 CodeRabbit supports most widely used languages. You can configure this in the
 repository settings.
 
-#### **8. What access does CodeRabbit need to my repositories?**
+#### What access does CodeRabbit need to my repositories?
 
 CodeRabbit requests minimal access to perform code reviews and post comments on
 Pull Requests. On GitHub, it requires read access to metadata, code,
 discussions, issues, and read/write access to the pull requests. On GitLab, it
 requires read access to the repository, and the CodeRabbit Bot user requires a
 developer role.
 
-#### **9. How can I add or remove users for my subscription?**
+#### How can I add or remove users for my subscription?
 
 To manage users, log in to CodeRabbit and navigate to subscriptions. You can add
 or remove users as needed.
 
-#### **10. How can I interact with the CodeRabbit bot?**
+#### How can I interact with the CodeRabbit bot?
 
 To interact with CodeRabbit's bot, reply to the CodeRabbit Comment. If there are
 team members collaborating on pull requests, the bot stays silent by default but
-can be engaged by tagging **@Coderabbitai**. This feature allows you to provide
+can be engaged by tagging **@coderabbitai**. This feature allows you to provide
 context, generate test cases, or ask for specific code suggestions, all within
 the context of your code lines or entire files.
 
-#### **11. Can individual developers use CodeRabbit?**
+#### Can individual developers use CodeRabbit?
 
 Absolutely! Whether you're an individual developer or part of an organization,
 CodeRabbit can be your coding assistant, providing you with invaluable
 suggestions.
 
-#### **12. Which branches are the pull requests reviewed on?**
+#### Which branches are the pull requests reviewed on?
 
-CodeRabbit reviews pull requests on the default branch.
+CodeRabbit reviews pull requests on the default branch by default. You can
+change this in the repository settings.
 
-#### **13. Is it possible for CodeRabbit to include additional branches for review?**
-
-Yes, you can change it under the repository settings.
-
-#### **14. CodeRabbit Usage Limits**
+#### CodeRabbit Usage Limits
 
 There are hourly rate limits for each developer per repository:
 
@@ -89,18 +117,14 @@ There are hourly rate limits for each developer per repository:
 In-trial and open-source plans have lower rate limits than the paid plan. In all
 cases, we re-allow further reviews/conversations after a brief timeout.
 
-#### **15. I can't add CodeRabbit to my GitLab Repositories?**
+#### I can't add CodeRabbit to my GitLab Repositories. What should I do?
 
 If there are any access restrictions by domain, then you will need to add
 `coderabbit.ai` as an allowed domain.
 
-:::note
+:::tip
 
-We are continually innovating and enhancing our application with new
-capabilities. Stay tuned and follow us for updates as new exciting features are
-built. We're committed to making your experience with CodeRabbit even better.
+If you have further questions or need additional information, please check out
+our [Support](../about/support.md) page for more details.
 
 :::
-
-If you have further questions or need additional information, don't hesitate to
-reach out to us at [[email protected]](mailto:[email protected]).