Add CI docs

.floe/config.json

@@ -6,9 +6,10 @@
   },
   "rulesets": {
     "docs": {
-      "include": ["**/*.md", "**/*.mdx"],
+      "include": ["apps/web/pages/docs/**/*.{md,mdx}"],
       "rules": {
-        "spelling-and-grammar": "warn"
+        "spelling-and-grammar": "warn",
+        "docs-style": "warn"
       }
     }
   }

.floe/rules/docs-style.md

@@ -0,0 +1 @@
+- Don't use we or I. Use the third person.

apps/web/pages/docs/_meta.json

@@ -7,6 +7,7 @@
   "quick-start": "Quick start",
   "usage": "Basic usage",
   "configuration": "Configuration",
+  "ci": "CI",
   "-- API reference": {
     "type": "separator",
     "title": "API reference"

apps/web/pages/docs/ci.mdx

@@ -0,0 +1,50 @@
+import { Callout } from 'nextra/components'
+
+# CI
+
+Using the Floe Reviews GitHub Action is the easiest way to integrate Floe
+Reviews into your CI pipeline. The action will automatically review your pull
+request diffs and leave comments for issues and suggested fixes.
+
+## Usage
+
+Copy the following workflow into your repository's `.github/workflows` directory.
+
+<Callout emoji="💡">Be sure to set `FLOE_API_WORKSPACE` and
+`FLOE_API_SECRET` on the "Actions secrets and variables" page in your GitHub
+settings. `GITHUB_TOKEN` is available by default.</Callout>
+
+```yaml copy filename=".github/workflows/floe-review.yml"
+name: "Floe Review"
+on:
+  pull_request:
+
+jobs:
+  Review:
+    env:
+      FLOE_API_WORKSPACE: ${{ secrets.FLOE_API_WORKSPACE }}
+      FLOE_API_SECRET: ${{ secrets.FLOE_API_SECRET }}
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # Checkout the Floe repository
+      - name: Checkout Floe
+        uses: actions/checkout@v4
+        with:
+          repository: Floe-dev/floe
+          ref: "@floe/[email protected]"
+          path: ./.github/actions/floe-actions
+
+      # Run the review action
+      - name: Review
+        uses: ./.github/actions/floe-actions/actions/review-action
+```
+
+## Versioning
+
+The Floe Review GitHub Action is verisoned using the `ref` attribute and passing
+a git tag. You can find the latest `@floe/review-action`
+[here](https://github.com/Floe-dev/floe/tags).