Initial commit: open-sourcing Warp docs

.env.example

@@ -0,0 +1,15 @@
+# Copy to `.env` (or set via your shell) to enable optional integrations.
+# `.env`, `.env.local`, and `.env.production` are all gitignored.
+#
+# Both of these values are PUBLIC (they're shipped to the browser by Astro's
+# `envField`, and live behind rate limiting / allow-lists on the vendor side).
+
+# Kapa Custom Frontend integration ID for the "Ask AI" button in the header.
+# If unset, the Ask AI button is hidden and the site still runs normally.
+# Get yours at: https://app.kapa.ai/admin
+PUBLIC_KAPA_INTEGRATION_ID=
+
+# PushFeedback project ID for the per-page "Was this helpful?" widget and the
+# feedback widget on the Scalar API page. If unset, both widgets are hidden.
+# Dashboard: https://app.pushfeedback.com
+PUBLIC_PUSHFEEDBACK_PROJECT_ID=

.github/ISSUE_TEMPLATE/BUGS.yml

@@ -0,0 +1,52 @@
+name: "Docs site bug"
+description: Report a problem with the docs website, not the documentation content.
+labels:
+  - bug
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Issue description
+      description: Describe the problem you experienced while using the Warp Docs website.
+      placeholder: The page does not load, search is not working, navigation is broken, etc.
+    validations:
+      required: true
+  - type: textarea
+    id: pages
+    attributes:
+      label: Page or pages affected
+      description: Provide the URL of each page where the issue occurs.
+      placeholder: https://docs.warp.dev/getting-started/quickstart/installation-and-setup
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: Describe what you expected to happen.
+      placeholder: I expected...
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: Describe what happened instead.
+      placeholder: Instead...
+    validations:
+      required: true
+  - type: input
+    id: browser
+    attributes:
+      label: Browser
+      description: Include your browser and version if the issue appears browser-specific.
+      placeholder: Chrome 124, Safari 17, Firefox 125, etc.
+    validations:
+      required: false
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add screenshots, recordings, error messages, or other details that may help us investigate.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/CONTENT.yml

@@ -0,0 +1,40 @@
+name: "Docs content issue"
+description: Report incorrect, outdated, missing, or unclear documentation.
+labels:
+  - improve or update documentation
+body:
+  - type: markdown
+    attributes:
+      value: "Minor fixes like typos, broken links, and short clarifications can go straight to a pull request."
+  - type: input
+    id: subject
+    attributes:
+      label: Subject area or topic
+      description: Which product area or documentation topic does this affect?
+      placeholder: Agent Mode, Warp Drive, cloud agents, API keys, billing, etc.
+    validations:
+      required: true
+  - type: textarea
+    id: pages
+    attributes:
+      label: Page or pages affected
+      description: Provide the URL of each affected page, or suggest where new content should live.
+      placeholder: https://docs.warp.dev/agent-platform/capabilities/skills
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What is incorrect, outdated, missing, or unclear?
+      description: Describe the documentation problem and why it matters.
+      placeholder: This page says..., but the current behavior is...
+    validations:
+      required: true
+  - type: textarea
+    id: suggested
+    attributes:
+      label: Suggested update
+      description: Share the correction, source context, or proposed direction if you have one.
+      placeholder: The page should say...
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask the Warp community
+    url: https://go.warp.dev/join-preview
+    about: This issue tracker is not for support questions. Join the Warp community Slack for help.
+  - name: Read the contribution guide
+    url: https://github.com/warpdotdev/docs/blob/main/CONTRIBUTING.md
+    about: Learn how to contribute to Warp Docs.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## Summary
+
+<!-- What changed and why? -->
+
+## Related issues
+
+<!-- Link issues, discussions, or source context. Write "None" if this is a small fix. -->
+
+## Validation
+
+<!-- List the checks you ran, or explain why a check was not run. -->
+
+## Screenshots
+
+<!-- Optional. Add screenshots for visual changes like navigation, asset, or layout updates. -->
+
+## Follow-ups
+
+<!-- Note any intentional follow-up work or out-of-scope items. -->

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build, link-check, audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type-check
+        run: npm run typecheck
+
+      - name: Build site
+        run: npm run build
+
+      - name: Check internal links
+        run: python3 .warp/skills/check_for_broken_links/check_links.py --internal-only
+
+      # Production-only audit; gate on high+ so dev-only deprecation chatter
+      # doesn't break PRs. The `|| true` keeps it informational; tighten this
+      # to a hard fail once we're confident the noise is gone.
+      - name: npm audit (production deps)
+        run: npm audit --omit=dev --audit-level=high || true