docs: reposition Kite as an AI marketer in Slack (entity cleanup)

[devon-appsmith]

What this PR does

The docs described Kite as a website builder. They now describe Kite as an AI marketer in Slack whose capabilities include website building, and, after the 2026-08-21 product review, they describe what Kite actually does rather than what the marketing narrative implied.

Commits, in order:

1. Framing pages. The homepage, Get Started, the site tagline, a site-wide meta description, the README, and a new docs llms.txt open with the canonical entity line, used verbatim.
2. Structure. The sidebar is regrouped (Get Started, Working with Kite in Slack, What Kite can do, Website Building, Plans, Account, Troubleshooting) and the Slack and capability pages are added. No files were moved or renamed.
3. Facts and voice. Pricing, sign-up, integrations, and support pages corrected against kite.ai; voice rules applied across every page.
4. Welcome page edit. The bridge sentence was removed from the homepage opening.
5. Review pass, part one: what Kite does on its own versus on request. The framing, Slack, and capabilities pages are rewritten around the real behaviour: offers of work on joining a channel, an hourly scan of the team's own Slack messages with up to three digests a day, results posted back into the originating thread, scheduled and webhook workflows, and everything else on request. The propose-first default and act-first alternative replace the "nothing goes live without approval" guarantee. Reddit, pull-request watching, calendar walkthroughs, the Day 1 to 5 week, and the weekly plan are gone. The new voice applies: the differentiator line runs unhedged, at most one hedge per page, and none of the banned approval register.
6. Review pass, part two: facts across website, plan, and account pages. Every hard contradiction in Part 1 of the review, the resolved TODOs in Part 2, the missing capabilities in Part 3, and the decisions in Part 4 are applied. troubleshooting/database-ssl.md is deleted.

The branch builds cleanly at the head (npm run build, with broken links set to fail the build).

Judgment calls worth knowing about

• One URL is removed and redirected. /troubleshooting/database-ssl is deleted as the review recommended. A permanent (301) redirect in website/vercel.json sends it to /troubleshooting, so the indexed URL keeps resolving. The redirect is applied by Vercel, so it shows up on the PR preview deployment rather than in a local build.
• The differentiator line is on the homepage as well as llms.txt. The voice guide lists "llms.txt, press, directories, anywhere a parser reads" for the third-person form. The docs homepage is parser-read, so it carries the line too. Easy to remove if you want it limited to llms.txt.
• The bridge sentence lost its approval clause. README and llms.txt now read "Building and hosting your website is one of the ways it executes that strategy." The "nothing goes live without your approval" clause was a hedge riding in the same breath as an autonomy claim, which the new voice rules out.
• "Thumbs up" is not used for approvals. The voice guide's example says approvals happen "with a thumbs up or quick reply." The code has no emoji-reaction handling, so the docs say "a quick reply" and describe the real Approve, Preview, and Review buttons.
• capabilities/free-tools.md is retitled "Tools on kite.ai." The review found the tools need an account and Growth Grader uses credits, so "free" was wrong. The file name and URL are unchanged.
• Site-wide meta description uses Docusaurus's themeConfig.metadata rather than headTags, so each page's own description still wins and no page gets two description tags.
• Social card reads "Kite" and "Your AI marketer in Slack" on two lines so the phrase stays intact at preview sizes.

Cheap path to raw markdown for agents (not built here)

Docusaurus does not serve the source .md files. The cheapest path is a small postBuild hook in docusaurus.config.js that copies docs/**/*.md into build/ alongside the rendered routes (for example /get-started/how-kite-works.md). About 20 lines of config, no new dependencies. Left for the queued raw-markdown task.

Changed files, one sentence each

Site configuration and root

• README.md: adds the canonical positioning line and the third-person differentiator line under the title.
• website/docusaurus.config.js: changes the tagline to "Help center for Kite, your AI marketer in Slack" and adds a site-wide description meta tag carrying the canon line.
• website/vercel.json: adds a permanent redirect from the deleted /troubleshooting/database-ssl URL to /troubleshooting.
• website/sidebars.js: regroups the sidebar, nests the five website sections under a "Website Building" umbrella with a generated index at /website-building, adds the new pages, and drops the deleted database page.
• website/static/llms.txt (new): mirrors kite.ai/llms.txt with the canon line, the differentiator line, page buckets, and agent guidance that states the propose-first default.
• website/static/img/social-card.png (new): a plain 1200x630 card for link previews; the config already pointed at this path but the file did not exist.

Get Started

• website/docs/intro.md: opens with the canon line and the differentiator line, describes what Kite does in a channel, carries one hedge, and lists the new sections and the Chat with us support path.
• website/docs/get-started/README.md: section overview, starting with adding Kite to Slack.
• website/docs/get-started/add-kite-to-slack.md (new): sign in first, the permissions the install asks for, inviting Kite (it never joins on its own), what it does on joining, the Connect Kite account button, and per-channel reply modes.
• website/docs/get-started/how-kite-works.md: what Kite does on its own, what it does when asked, the autonomy setting, Slack versus the browser editor, the Preview and Review buttons, credits.
• website/docs/get-started/quickstart.md: a walkthrough of the first conversation, from Kite's first offers to a reply of "publish it" (URL unchanged).

Working with Kite in Slack

• website/docs/slack/README.md (new): overview of the rhythm: ask or be offered, Kite does the work, Kite posts the result, you reply.
• website/docs/slack/what-kite-posts.md (new): offers of work, hourly digests, proposed initiatives with the Approve button, draft cards with Preview and Review, report announcements, home channel and reply modes.
• website/docs/slack/approvals.md (new): the propose-first default and act-first alternative, the three ways to give the OK, and the two actions that always wait for a person.
• website/docs/slack/asking-kite.md (new): how to request work in a thread, by DM, or by email to teamslug@kite.space, plus feedback and the browser handoff.
• website/docs/slack/team-access.md (new): Slack membership versus Kite team membership, the owner, admin, and member roles, and the first-marketing-hire guardrail.

What Kite can do

• website/docs/capabilities/README.md (new): overview of the capabilities and what Kite is not.
• website/docs/capabilities/research-and-growth-plan.md (new): research types, the Growth Grader checklist, and initiatives as the plan.
• website/docs/capabilities/content-and-outreach.md (new): the content Kite drafts and where it publishes (connected networks, email, the site), with no Reddit.
• website/docs/capabilities/product-marketing.md (new): launches on request, with the on-register "Your team merges the pull request. Kite launches the release." line and a workflow option for release rhythms.
• website/docs/capabilities/conversion-fixes.md (new): audits, A/B experiments, and fixes on request or on a scheduled workflow.
• website/docs/capabilities/website-building.md (new): website building as one capability, including import, GitHub sync, CMS editing, and the automatic SEO groundwork.
• website/docs/capabilities/initiatives-reports-and-workflows.md (new): the initiatives board, hosted reports, workflows, and custom agents, with gaps flagged.
• website/docs/capabilities/free-tools.md (new): Growth Grader, LinkedIn to Website, and Website Makeover, retitled "Tools on kite.ai."

Website Building: editing

• website/docs/building/README.md: reframes site building as one capability, adds the three design options and Slack-originated drafts.
• website/docs/building/editing-your-site.md: startup example, real version-restore label, link to the renamed stuck-chat page.
• website/docs/building/images-and-logos.md: adds image generation, editing, and background removal, plus formats and the 10 MB limit.
• website/docs/building/fonts-and-media.md: Google Fonts by name with no font uploads; video formats and the 100 MB limit.
• website/docs/building/pages-and-navigation.md: voice sweep only.
• website/docs/building/responsive-design.md: the viewport button that cycles Desktop, Tablet, and Mobile.
• website/docs/building/templates-and-duplicating.md: retitled "Starting Designs & Duplicating a Site," three options with restyle chips, and the Duplicate website menu item (URL unchanged).

Website Building: publishing

• website/docs/publishing/README.md: publishing overview with the 40-second deploy and Slack-originated publishes.
• website/docs/publishing/how-to-publish.md: the panel's progress, "Published · just now," the QR code, the disabled "No changes to update" state, and Search Console status.
• website/docs/publishing/your-kite-url.md: the Edit domain control for renaming your kite.space address.
• website/docs/publishing/changes-not-showing.md: removes "publish again to force a redeploy," which is not possible without an edit.
• website/docs/publishing/unpublish.md: there is no unpublish control; temporary takedown goes through support, a holding page is the alternative, and deletion is self-serve.
• website/docs/publishing/publish-failures.md: build errors with the Fix with assistant button; the redirect-status and config sections are removed.

Website Building: custom domains

• website/docs/custom-domains/README.md: paid-plan requirement, one domain per site, and the trial.
• website/docs/custom-domains/connect-a-custom-domain.md: root covers www, the subdomain caveat, the MX and TXT records in the setup, automatic republish, the real connecting notice, the Verification needed state, and disconnect in Settings.
• website/docs/custom-domains/registrar-guides.md: record types and the automatic republish.
• website/docs/custom-domains/www-vs-root.md: rewritten: connect the root and both addresses are served, with no primary/redirect choice.
• website/docs/custom-domains/transfer-and-email.md: which records Kite adds (including MX and TXT on their own labels) and why your mailbox is unaffected.
• website/docs/custom-domains/switch-or-reuse-domain.md: disconnect in Settings, deleting a site releases its domain, no support step.
• website/docs/custom-domains/troubleshooting.md: Verification needed added, 24 hours, disconnect in Settings, deletion releases domains.

Website Building: SEO

• website/docs/seo/README.md: automatic sitemap, robots, llms.txt, structured data, Search Console submission, and the Discoverability tab.
• website/docs/seo/seo-basics.md: startup examples; canonical switches to the custom domain automatically.
• website/docs/seo/sitemap-and-robots.md: rewritten: nothing to ask Kite for, the live sitemap, and automatic Search Console submission on paid plans.
• website/docs/seo/social-previews.md: the "Prototype" default stated plainly and the Discoverability tab as the place to check.
• website/docs/seo/migrate-existing-site.md: rebuilt around keeping URLs identical because Kite cannot add 301 redirects.

Website Building: forms and integrations

• website/docs/forms-integrations/README.md: overview of forms, the Leads inbox, analytics, scripts, and the Integrations page.
• website/docs/forms-integrations/contact-forms.md: the site contact email set in chat, the Leads inbox, notifications from notifications@kite.space, and no recipient field on the form.
• website/docs/forms-integrations/chat-and-scripts.md: the Content Security Policy section is removed because the policy allows every script.
• website/docs/forms-integrations/analytics.md: the four tabs, Free versus paid, PostHog, and asking Kite about the numbers.
• website/docs/forms-integrations/integrations.md: the Integrations page, GitHub two-way sync, social networks, email from teamslug@kite.space, external CMS, the 3,000+ catalog, and bring-your-own MCP server.

Plans, Pricing & Credits

• website/docs/pricing-credits/README.md: overview with the trial, one credit equals one dollar, owners manage billing, and the out-of-credits message.
• website/docs/pricing-credits/plans-and-trial.md: Free ($15 one-time), Growth ($100 per month or $1,020 per year), Business (custom), the 5-day trial and its downgrade wizard, paid-only features, and the launch offer line kept as written.
• website/docs/pricing-credits/how-credits-work.md: the three kinds of credits and the order they are spent, what happens when they run out, and the Stop button for loops.
• website/docs/pricing-credits/buy-credits.md: the $20, $50, and $100 packs, paid plan and owner role required, Stripe.
• website/docs/pricing-credits/manage-subscription.md: Upgrade and Downgrade cards open Stripe, View invoices, owner-only, and what changes on the way to Free.
• website/docs/pricing-credits/remove-kite-badge.md: badge removal is Growth and Business, the Settings toggle by name, and the badge returns on downgrade.

Account & Settings

• website/docs/account/README.md: overview with roles, export, and deletion by request.
• website/docs/account/login-and-signup.md: Google or email one-time code, no passwords, the Slack install needs a signed-in member, and the Connect Kite account button.
• website/docs/account/delete-account.md: deletion is a support request, refused while a subscription is active, immediate and irreversible, with shared teams preserved.
• website/docs/account/export-your-site.md: the Export code button in site Settings and what the ZIP contains.

Troubleshooting

• website/docs/troubleshooting/README.md: the Slack problems list, the read-only older-site state, and how to reach support through Chat with us.
• website/docs/troubleshooting/preview-not-loading.md: rewritten around "Preview couldn't start" and the Retry button.
• website/docs/troubleshooting/editor-frozen.md: rewritten around the message queue, the Stop button, stream errors, and the "Something went wrong" screen; no lock for support to release.
• website/docs/troubleshooting/version-history.md: the real labels, restoring uses credits and creates a "Restored:" version.
• website/docs/troubleshooting/email-sending.md: notifications from notifications@kite.space to the site contact email, the Leads inbox, no sender verification.
• website/docs/troubleshooting/database-ssl.md (deleted): described a configuration users cannot reach; Kite provisions and secures the database itself.

Needs product confirmation

Each item is marked in the file with the <!-- TODO: verify ... --> convention. Nothing here was guessed.

• Where the team's autonomy setting (propose first / act first) lives in the product UI.
• Where the per-channel reply mode (follow threads, respond when tagged, retired) is set.
• Where the team's teamslug@kite.space email address is shown to users.
• How the browser handoff for logins and two-factor codes appears to the user.
• The initiatives board: its location and labels in the browser workspace.
• Report pinning controls and where hosted reports are listed.
• How workflows are created and where their run history appears.
• The custom agents and skills setup path.
• What Website Makeover takes as input and produces (not in the product codebase).
• The labels for the integrations catalog and the bring-your-own MCP server form.
• End-of-period behaviour after canceling a paid plan, and whether purchased credits remain usable after a move to Free.
• Refund policy (not in code).
• Pre-existing TODOs untouched by the review: pages-and-navigation.md (how page URLs are set and edited), images-and-logos.md (exact image-frame behaviour), registrar-guides.md (current menu labels at each registrar), and seo-basics.md (title character guidance).

Engineering issues from the review

The five engineering items in Part 4 of the review (purchased domains not renewing, badge removal without a plan gate, the unread CMS OG Image field, the placeholder Business price, the stale "up to 5 websites" prompt) are not addressed in this PR and are tracked with the engineering team separately.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
kite-docs	Ready	Preview	Aug 21, 2026 5:25pm