Add about and use VSCode files

Author: jmacdotorg

docs/guides/about-vscode.md

@@ -0,0 +1,30 @@
+---
+title: Overview
+description: How to review your code with the VSCode extension.
+---
+
+This page is about the CodeRabbit VSCode extension. For a broader overview of CodeRabbit, see [Introduction](/overview/introduction).
+
+## About the VSCode extension
+
+The CodeRabbit VSCode extension lets you apply a limited subset of CodeRabbit’s code-review features to your local development environment, directly from the VSCode IDE.
+
+## Features
+
+The extension includes the following features:
+
+- Automatic reviews of local Git commmits
+
+- Manually requested reviews of local code changes
+
+## Price and limitations
+
+This extension is free to install and use, and works with any tier of CodeRabbit account. You can use the extension on its own, or you can use it to complement your local development on a repository whose remote has CodeRabbit installed.
+
+Rate limits apply to the numnber of local reviews that you can request per hour.
+
+## What's next
+
+- [Install the VSCode extension](/guides/install-extension)
+
+- [Use the VSCode extension](/guides/use-extension)

docs/guides/use-vscode.md

@@ -0,0 +1,39 @@
+---
+title: Use the VSCode extension
+description: How to review your code with the VSCode extension.
+---
+
+This page is about using the CodeRabbit VSCode extension. For more information about the extension, see
+[Overview](/guides/about-vscode). To learn how to install the extension, see [Install the VSCode extension](/guides/install-vscode).
+
+## Review your code changes
+
+To manually review changes in a local Git branch using the CodeRabbit VSCode extension, follow these steps:
+
+1.  Click the CodeRabbit icon in the VSCode activity bar. The CodeRabbit sidebar appears.
+
+1.  Refer to **Branch** in the CodeRabbit sidebar. If you want to compare your code changes
+    to a branch other than the default that appears, then follow these steps:
+
+        1. Click the name of the base branch, which is `main` by default. A **Select a base branch** dialog appears, listing other branches in your local Git repository.
+
+        1. Select the name of a base branch to compare against.
+
+1.  Select one of the review-action options from the menu at the bottom of the CodeRabbit sidebar:
+
+    - To review all changes between the base branch and your current branch, including
+      both committed and uncommitted changes, select **Review all changes**. This is the default selection.
+
+    - To limit the review to only changes on your branch that you have committed, select **Review committed changes**. This includes both pushed and not-pushed commits on the current branch.
+
+    - To limit the review to only uncommitted changes on your branch, select **Review all changes**.
+
+1.  Refer to the list of **Files to review** in the sidebar. This list represents all of the files that the selected review style includes. To change this list of files, repeat the previous step to choose a different review style, or use Git features like `git stash` to remove changes to files.
+
+1.  To perform the review, click the button part of the menu. The CodeRabbit sidebar displays a **Review** section with the review's progress.
+
+1.  Wait for the review to complete. This might take several minutes. To cancel a review in progress, click **Stop the review**.
+
+## What's next
+
+- The CodeRabbit [Introduction](/overview/introduction) describes how you can complement the CodeRabbit VSCode extension by setting up automatic, full-featured code reviews on your remote repository's pull requests.