Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

removed contact us from first accordion on quickstart page_anahita #354

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

removed contact us from first accordion on quickstart page_anahita #354

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
71ad12c
Documentation edits made through Mintlify web editor
mintlify[bot] Nov 14, 2024
97da41d
Documentation edits made through Mintlify web editor
mintlify[bot] Nov 14, 2024
bad9596
Documentation edits made through Mintlify web editor
hahnbeelee Nov 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 16 additions & 41 deletions quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,9 @@ icon: "rocket"
---

<Frame>
<img
className="block dark:hidden"
src="https://mintlify-assets.b-cdn.net/hero-light.png"
/>
<img
className="hidden dark:block"
src="https://mintlify-assets.b-cdn.net/hero-dark.png"
/>
<img className="block dark:hidden" src="https://mintlify-assets.b-cdn.net/hero-light.png" />

<img className="hidden dark:block" src="https://mintlify-assets.b-cdn.net/hero-dark.png" />
</Frame>

## Getting Started
Expand All @@ -28,25 +23,14 @@ your docs with your code, and make source control effortless.

<AccordionGroup>
<Accordion icon="github" title="Creating Your Documentation Repository">

If you've created a docs repo in our onboarding, this step is complete. You can find your docs repository on your Mintlify [dashboard](https://dashboard.mintlify.com).

To create your docs repo without logging into Github, follow these instructions:
1. Clone our [starter template](https://github.com/mintlify/starter) into a new public repo. You can make the repo private later.
2. [Get in touch](mailto:[email protected]) with our team to deploy your repo.

![Starter Template](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/starter-template.png)

If you've created a docs repo in our onboarding, this step is complete. If [you'd like to](https://) test out Mintlify locally you can clone our [starter kit](https://github.com/mintlify/starter).
</Accordion>

<Accordion icon="message-bot" title="Installing Our Github App">

The next step is to install our Github app. This ensures 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)

</Accordion>

</AccordionGroup>

### 2. Updating Your Docs
Expand All @@ -61,12 +45,14 @@ your docs.

<AccordionGroup>
<Accordion icon="rectangle-terminal" title="Setting up Your Editing Environment">

**Edit Locally (Recommended for Developers):**

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 <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).

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 [development guide](/development).

**Editing Online:**
Expand All @@ -75,22 +61,22 @@ your docs.

* To edit a single file, locate and click the edit button. This will open a web editor right on Github.
![Edit Online](https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/edit-online.png)
* For a more versatile online experience, open your git repository in Github's [github.dev](https://github.dev) online IDE. Simply replace `github.com` in your repo URL with `github.dev`. For example, use `github.dev/mintlify/docs` instead of `github.com/mintlify/docs`.


* For a more versatile online experience, open your git repository in Github's [github.dev](https://github.dev) online IDE. Simply replace `github.com` in your repo URL with `github.dev`. For example, use `github.dev/mintlify/docs` instead of `github.com/mintlify/docs`.

> **Monorepo Setup** <br/>
> **Monorepo Setup** <br />
> We also support a mono-rep setup, allowing you to add our starter template within a docs folder in your existing repo.
>
> 1. Clone the starter template and move its contents into your docs folder
>
> 2. Delete the .git directory.
> 3. You can also choose the path to your mint.json in the dashboard under 'Settings' <br/>
> ![Monorepo](/images/monorepo.png) <br/>
> The mono-repo setup eliminates the need for creating a new repo.

>
> 3. You can also choose the path to your mint.json in the dashboard under 'Settings' <br />
> ![Monorepo](/images/monorepo.png) <br />
> The mono-repo setup eliminates the need for creating a new repo.
</Accordion>

<Accordion icon="palette" title="Customizing Your Brand (mint.json)">

Easily customize colors, logos and buttons among other configurations in our `mint.json` file. Start with these basic configurations:

```json
Expand All @@ -109,11 +95,9 @@ your docs.
```

A full list of supported configurations can be found [here](/settings/global).

</Accordion>

<Accordion icon="pencil" title="Adding Content">

Add content with simple MDX files. Initiate your pages with this template:

```md
Expand All @@ -125,15 +109,12 @@ your docs.
```

Learn more about adding images, tables, lists, and more using the [MDX syntax](/text). We also offer a wide array of components which are listed [here](/content/components).

</Accordion>

<Accordion icon="rocket" title="Pushing Your Changes">

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)

</Accordion>
</AccordionGroup>

Expand All @@ -144,7 +125,6 @@ analytics, and versioning to accommodate any of your documentation needs.

<AccordionGroup>
<Accordion icon="code-branch" title="Generating API References">

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.
Expand All @@ -162,21 +142,16 @@ analytics, and versioning to accommodate any of your documentation needs.
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).

</Accordion>

<Accordion icon="star" title="Adding a Custom Domain">

Integrate your docs into your website by hosting them on a custom domain. This is included even in the free Mintlify plan. Navigate to your [dashboard settings](https://www.dashboard.mintlify.com/settings) to add a custom domain.

![Custom Domain](/images/custom-domain.png)

</Accordion>

<Accordion icon="chart-simple" title="Adding Analytics">

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).

</Accordion>
</AccordionGroup>

Expand All @@ -185,4 +160,4 @@ analytics, and versioning to accommodate any of your documentation needs.
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
[[email protected]](mailto:[email protected]).
[[email protected]](mailto:[email protected]).
Loading