mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
66193e6628
* docs: tighten long sentence and checklist intro in migration guides * Update migration-services/go-live-checklist.mdx * Update migration/gitbook.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
48 lines
3.3 KiB
Plaintext
48 lines
3.3 KiB
Plaintext
---
|
|
title: "Go-live checklist"
|
|
description: "A pre-launch checklist to verify redirects, custom domain, authentication, analytics, and SEO settings before your Mintlify docs site goes live."
|
|
noindex: true
|
|
---
|
|
|
|
Use this checklist to set up configurations and validate settings before going live. Some steps may not apply to your deployment.
|
|
|
|
## Core setup
|
|
|
|
- **Connect your docs repo to Mintlify.** Install the [GitHub App](/deploy/github), connect your [GitLab repository](/deploy/gitlab), or connect your [Bitbucket Cloud repository](/deploy/bitbucket).
|
|
- If you store your documentation in more than one repository, configure a [multi-repository structure](/deploy/multi-repo) to build your site from multiple repos. If all of your content is in a single repository, skip this step.
|
|
- **Invite team members.** Invite anyone who needs access from the [Members](https://app.mintlify.com/settings/organization/members) page in your dashboard. See [Roles](/dashboard/roles) for more information.
|
|
|
|
## Security
|
|
|
|
- Review who can access your dashboard.
|
|
- Set up [dashboard SSO](/dashboard/sso) for your team to access your dashboard and editor.
|
|
- Set up [dashboard access policies](/dashboard/network-access).
|
|
- Set up [SCIM provisioning](/dashboard/scim).
|
|
- Review your Mintlify site access.
|
|
- If you restrict your site to certain users, set up [authentication](/deploy/authentication-setup).
|
|
- Review which groups have access to pages and which pages are public.
|
|
|
|
## Content validation
|
|
|
|
- **Verify your information architecture.** Is this the proper navigation structure? Are there missing sections? See [content types](/guides/content-types) for reference.
|
|
- **Verify your information is up-to-date.** Are all recent content changes reflected on your site?
|
|
- If required, set up [redirects](/create/redirects).
|
|
- **Configure SEO settings.** Set your site description, meta tags, and indexing preferences in `docs.json`. See [SEO and search settings](/organize/settings-seo).
|
|
- **Review page-level SEO.** Configure meta tags, Open Graph properties, and canonical URLs where needed. See [SEO](/optimize/seo).
|
|
|
|
## Dashboard features
|
|
|
|
- **Turn on and configure the assistant.** See [Configure the assistant](/assistant/configure).
|
|
- Configure your [support and sales deflection emails](/assistant/configure#set-deflection-emails).
|
|
- Configure your [search domains](/assistant/configure#search-domains).
|
|
- Customize the [assistant's response patterns](/assistant/customize) and [add assistant skills](/assistant/skills).
|
|
- **Embed the assistant widget.** Enable the [assistant widget](/assistant/widget) to add the assistant to your product dashboard, marketing site, or support portal.
|
|
- **Enable add-ons.** Go to the [Add-ons](https://app.mintlify.com/settings/deployment/addons) page in your dashboard. Enable relevant add-ons such as agent feedback, [CI checks](/deploy/ci), related topics, and more.
|
|
- **Set up the Slack agent.** This lets you make changes to your content directly in Slack. See [Add the agent to Slack](/agent/slack#add-the-agent-to-slack).
|
|
- **Set up automations.** See [how to enable an automation](/automations/manage#enable-an-automation).
|
|
- **Install relevant analytics plugins.** See the [list of analytics integrations](/integrations/analytics/overview).
|
|
|
|
## Go live
|
|
|
|
- **Set your custom domain.** See the [custom domain guide](/customize/custom-domain).
|