diff --git a/NationalParksPoster.jpg b/NationalParksPoster.jpg new file mode 100644 index 000000000..519fe91ff Binary files /dev/null and b/NationalParksPoster.jpg differ diff --git a/analytics/amplitude.mdx b/analytics/amplitude.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/amplitude.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/clearbit.mdx b/analytics/clearbit.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/clearbit.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/fathom.mdx b/analytics/fathom.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/fathom.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/google.mdx b/analytics/google.mdx new file mode 100644 index 000000000..a7e5735fd --- /dev/null +++ b/analytics/google.mdx @@ -0,0 +1,166 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). + +*** + +title: 'New file' +description: 'Description of your new file.' +-------------------------------------------- + +Hello world. \ No newline at end of file diff --git a/analytics/heap.mdx b/analytics/heap.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/heap.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/koala.mdx b/analytics/koala.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/koala.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/logrocket.mdx b/analytics/logrocket.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/logrocket.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/mixpanel.mdx b/analytics/mixpanel.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/mixpanel.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/plausible.mdx b/analytics/plausible.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/plausible.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/posthog.mdx b/analytics/posthog.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/posthog.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/analytics/segment.mdx b/analytics/segment.mdx new file mode 100644 index 000000000..7b713eab7 --- /dev/null +++ b/analytics/segment.mdx @@ -0,0 +1,158 @@ +--- +title: "Quickstart" +description: "Start building modern documentation in under five minutes" +icon: "rocket" +--- + + + + + + + +## Getting Started + +Welcome! Follow the instructions below to learn how to deploy, update and +supercharge your documentation with Mintlify. + +### Creating the Repository + +Mintlify docs are rendered from MDX files and configurations defined in our +[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate +your docs with your code, and make source control effortless. Onboard through the [dashboard](https://dashboard.mintlify.com) or clone our [starter kit](https://github.com/mintlify/starter) to get started. + + + + Install our GitHub app to ensure that your updates are automatically deployed when you push changes. You can find the installation link in the [dashboard](https://dashboard.mintlify.com/settings), on the Settings page. Upon successful installation, a check mark will appear next to the commit hash of the repository. + + + ![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png) + + + + + If you want your docs to live alongside your code as a monorepo setup, you + can: 1. Move your docs content to your monorepo. 2. Specify the path to your + `mint.json` in the + [dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings) + + + Monorepo setup + + Monorepo setup + + + + +### Updating the Content + +Mintlify enables you to easily customize the style, structure, and content of +your docs. + + + + 1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). + + 2. Once git is installed, clone your docs repository using `git clone `. If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). + + 3. Use your favorite IDE to open the repository. + + 4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`. + + Learn more about this in our [local development guide](/development). + + + + Learn more about how to use the web editor on our [guide](/web-editor). + + + + Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations: + + ```json + "name": "Your Company" + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://yourcompany.com" + }, + "favicon": "/favicon.svg", + "colors": { + "primary": "#2AB673", + "light": "#55D799", + "dark": "#117866", + }, + ``` + + A full list of supported configurations can be found at [global settings](/settings/global). + + + + Add content with simple MDX files. Initiate your pages with this template: + + ```md + --- + title: "Page Title" + sidebarTitle: "Sidebar title (optional - if different from page title)" + description: "Subtitle (optional)" + --- + ``` + + Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components). + + + + Once ready, commit and push your changes to update your docs site. Here is a [guide](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) on how to do that. If the GitHub app is unable to successfully deploy your changes, you can manually update your docs through our [dashboard](https://dashboard.mintlify.com). + + + ![Manual + Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png) + + + + + You can easily set up your API references using an OpenAPI document. + + 1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `mint.json` with a URL. + + ```json + "openapi": "link-to-your-openapi-file" + ``` + + 2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as: + + ```bash + npx @mintlify/scraping@latest openapi-file + ``` + + 3. Finally, include the generated endpoint MDX files to your `mint.json` under `navigation`. + + For a complete guide on using Mintlify with OpenAPI, check out [this guide](/api-playground/openapi/setup). [This guide](/api-playground/openapi/writing-openapi) explains how to configure your API authentication methods. For manual API references definition, explore [our syntax](/api-playground/overview). + + + + Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your [dashboard](https://dashboard.mintlify.com/analytics). + + We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview). + + + + + We provide a white-glove migration service as part of our Enterprise plan. + Interested? You can request it by [contacting us](mailto:sales@mintlify.com). + + +### Publishing + + + Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan. + + Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain. + + ![Custom Domain](/images/custom-domain.png) + + +Congrats! You've set up your Mintlify Docs and it's looking amazing! Need +support or want to give some feedback? You can join our +[community](https://mintlify.com/community) or drop us an email at +[support@mintlify.com](mailto:support@mintlify.com). \ No newline at end of file diff --git a/changelog/overview.mdx b/changelog/overview.mdx index ad2c56f93..379c1c2c6 100644 --- a/changelog/overview.mdx +++ b/changelog/overview.mdx @@ -3,6 +3,9 @@ title: "Product Updates" description: "New updates and improvements" mode: "center" --- + +Edited + ## Authentication diff --git a/content/components/accordion-groups.mdx b/content/components/accordion-groups.mdx index 29f90169c..dd97ce91f 100644 --- a/content/components/accordion-groups.mdx +++ b/content/components/accordion-groups.mdx @@ -4,6 +4,8 @@ description: "Group multiple accordions into a single display." icon: "table-rows" --- +Edited file. + Simply add `` around your existing `` components. diff --git a/development.mdx b/development.mdx index 856629aaf..9a0b75bb6 100644 --- a/development.mdx +++ b/development.mdx @@ -3,6 +3,8 @@ title: 'Local Development' description: 'Preview changes locally to update your docs' --- +Edited file + **Prerequisite**: Please install Node.js (version 19 or higher) before proceeding. diff --git a/image-embeds.mdx b/image-embeds.mdx index 5c12f772b..8d07db0b2 100644 --- a/image-embeds.mdx +++ b/image-embeds.mdx @@ -4,10 +4,7 @@ description: 'Add image, video, and other HTML elements' icon: 'image' --- - + Mintlify supports files up to 5 MB. To use larger files, consider a storage @@ -16,6 +13,8 @@ icon: 'image' ## Image +![](/NationalParksPoster.jpg) + ### Using Markdown The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code @@ -65,31 +64,18 @@ To use separate images for light and dark mode, use Tailwind CSS to hide and sho For more information, we recommend the following sections: - + Read the reference for the Frame component ## Videos - +