Skip to content

Commit 99c1eac

Browse files
Documentation edits made through Mintlify web editor
1 parent 7724d2c commit 99c1eac

File tree

1 file changed

+52
-67
lines changed

1 file changed

+52
-67
lines changed

quickstart.mdx

Lines changed: 52 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
---
22
title: "Quickstart"
3-
description: "Start building modern documentation in under five minutes"
3+
description: "Start building modern documentation in under five minutes
4+
5+
6+
"
47
icon: "rocket"
58
---
69

@@ -9,6 +12,7 @@ icon: "rocket"
912
className="block dark:hidden"
1013
src="https://mintlify-assets.b-cdn.net/hero-light.png"
1114
/>
15+
1216
<img
1317
className="hidden dark:block"
1418
src="https://mintlify-assets.b-cdn.net/hero-dark.png"
@@ -17,46 +21,47 @@ icon: "rocket"
1721

1822
## Getting Started
1923

20-
Welcome! Follow the instructions below to learn how to deploy, update and
24+
Welcome\! Follow the instructions below to learn how to deploy, update and
2125
supercharge your documentation with Mintlify.
2226

27+
<Accordion title="New Accordion" icon="sparkles">
28+
Testing here
29+
</Accordion>
30+
2331
### Creating the Repository
2432

2533
Mintlify docs are rendered from MDX files and configurations defined in our
2634
[starter kit](https://github.com/mintlify/starter). We use GitHub to integrate
2735
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.
2836

2937
<AccordionGroup>
30-
31-
<Accordion icon="message-bot" title="Install the GitHub app">
32-
38+
<Accordion title="Install the GitHub app" icon="message-bot">
3339
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.
3440

3541
<Frame>
36-
![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png)
42+
![GitHub Bot Verification](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/github-bot-verification.png)
3743
</Frame>
38-
3944
</Accordion>
45+
<Accordion title="Monorepo Setup" icon="code-branch">
46+
If you want your docs to live alongside your code as a monorepo setup, you
47+
can: 1. Move your docs content to your monorepo. 2. Specify the path to your
48+
`docs.json` in the
49+
[dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings)
4050

41-
<Accordion icon="code-branch" title="Monorepo Setup">
42-
If you want your docs to live alongside your code as a monorepo setup, you
43-
can: 1. Move your docs content to your monorepo. 2. Specify the path to your
44-
`docs.json` in the
45-
[dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings)
46-
<Frame>
47-
<img
48-
alt="Monorepo setup"
49-
className="block dark:hidden"
50-
src="/images/monorepo-light.png"
51-
/>
52-
<img
53-
alt="Monorepo setup"
54-
className="hidden dark:block"
55-
src="/images/monorepo-dark.png"
56-
/>
57-
</Frame>
58-
</Accordion>
59-
51+
<Frame>
52+
<img
53+
alt="Monorepo setup"
54+
className="block dark:hidden"
55+
src="/images/monorepo-light.png"
56+
/>
57+
58+
<img
59+
alt="Monorepo setup"
60+
className="hidden dark:block"
61+
src="/images/monorepo-dark.png"
62+
/>
63+
</Frame>
64+
</Accordion>
6065
</AccordionGroup>
6166

6267
### Updating the Content
@@ -65,25 +70,18 @@ Mintlify enables you to easily customize the style, structure, and content of
6570
your docs.
6671

6772
<AccordionGroup>
68-
<Accordion icon="rectangle-terminal" title="Editing locally (recommended for developers)">
69-
73+
<Accordion title="Editing locally (recommended for developers)" icon="rectangle-terminal">
7074
1. Install [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git).
7175
2. Once git is installed, clone your docs repository using `git clone <your-repo>`. 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).
7276
3. Use your favorite IDE to open the repository.
7377
4. Install our Mintlify CLI to preview changes with `npm i -g mintlify`.
7478

7579
Learn more about this in our [local development guide](/development).
76-
7780
</Accordion>
78-
79-
<Accordion icon="pen-to-square" title="Editing with the web editor">
80-
81+
<Accordion title="Editing with the web editor" icon="pen-to-square">
8182
Learn more about how to use the web editor on our [guide](/web-editor).
82-
8383
</Accordion>
84-
85-
<Accordion icon="palette" title="Customizing to your brand">
86-
84+
<Accordion title="Customizing to your brand" icon="palette">
8785
Easily customize colors, logos and buttons among other configurations in our `docs.json` file. Start with these basic configurations:
8886

8987
```json
@@ -102,11 +100,8 @@ your docs.
102100
```
103101

104102
A full list of supported configurations can be found at [global settings](/settings/global).
105-
106103
</Accordion>
107-
108-
<Accordion icon="pencil" title="Adding content">
109-
104+
<Accordion title="Adding content" icon="pencil">
110105
Add content with simple MDX files. Initiate your pages with this template:
111106

112107
```md
@@ -118,22 +113,16 @@ your docs.
118113
```
119114

120115
Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a [wide array of components](/content/components).
121-
122116
</Accordion>
123-
124-
<Accordion icon="rocket" title="Pushing changes">
125-
117+
<Accordion title="Pushing changes" icon="rocket">
126118
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).
127119

128-
<Frame>
129-
![Manual
130-
Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png)
131-
</Frame>
132-
120+
<Frame>
121+
![Manual
122+
Update](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/manual-update.png)
123+
</Frame>
133124
</Accordion>
134-
135-
<Accordion icon="code-branch" title="Generating API references">
136-
125+
<Accordion title="Generating API references" icon="code-branch">
137126
You can easily set up your API references using an OpenAPI document.
138127

139128
1. Add your `openapi.yaml` or `openapi.json` file into your docs repository or define the `openapi` field in `docs.json` with a URL.
@@ -142,24 +131,20 @@ your docs.
142131
"openapi": "link-to-your-openapi-file"
143132
```
144133

145-
2. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as:
134+
1. Use our [scraper](/api-playground/openapi/setup#autogenerate-files-recommended) to autogenerate your OpenAPI endpoints files as:
146135

147136
```bash
148137
npx @mintlify/scraping@latest openapi-file <path-or-url-to-openapi-file>
149138
```
150139

151-
3. Finally, include the generated endpoint MDX files to your `docs.json` under `navigation`.
140+
1. Finally, include the generated endpoint MDX files to your `docs.json` under `navigation`.
152141

153142
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).
154-
155143
</Accordion>
156-
157-
<Accordion icon="chart-simple" title="Adding analytics">
158-
144+
<Accordion title="Adding analytics" icon="chart-simple">
159145
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).
160146

161147
We also support integrations with a range of analytics providers. You can find the list of providers [here](/integrations/analytics/overview).
162-
163148
</Accordion>
164149
</AccordionGroup>
165150

@@ -170,17 +155,17 @@ your docs.
170155

171156
### Publishing
172157

173-
<Accordion icon="star" title="Adding a custom domain">
174-
175-
Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan.
176-
177-
Navigate to your [dashboard settings](https://dashboard.mintlify.com/settings) to add a custom domain.
158+
<Accordion title="Adding a custom domain" icon="star">
159+
Integrate your docs into your website by hosting them on a custom domain. This is included in the free plan.
178160

179-
<Frame>![Custom Domain](/images/custom-domain.png)</Frame>
161+
Navigate to your [dashboard settings](https://dashboard.mintlify.com/settings) to add a custom domain.
180162

163+
<Frame>
164+
![Custom Domain](/images/custom-domain.png)
165+
</Frame>
181166
</Accordion>
182167

183-
Congrats! You've set up your Mintlify Docs and it's looking amazing! Need
168+
Congrats\! You've set up your Mintlify Docs and it's looking amazing\! Need
184169
support or want to give some feedback? You can join our
185170
[community](https://mintlify.com/community) or drop us an email at
186-
171+

0 commit comments

Comments
 (0)