mirror of
https://github.com/fosrl/docs-v2.git
synced 2026-02-25 14:26:44 +00:00
Update readme
This commit is contained in:
40
README.md
40
README.md
@@ -1,44 +1,50 @@
|
|||||||
# Mintlify Starter Kit
|
# Pangolin Documentation
|
||||||
|
|
||||||
Use the starter kit to get your docs deployed and ready to customize.
|
Welcome to the official documentation for [Pangolin](https://github.com/fosrl/pangolin), a modern reverse proxy and networking solution. This documentation site is hosted at [docs.digpangolin.com](https://docs.digpangolin.com) and provides comprehensive guides, API references, and resources for getting started with Pangolin.
|
||||||
|
|
||||||
Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with
|
## About This Documentation
|
||||||
|
|
||||||
- Guide pages
|
This documentation covers everything you need to know about Pangolin, including:
|
||||||
- Navigation
|
- Installation and setup guides
|
||||||
- Customizations
|
- Configuration options
|
||||||
- API reference pages
|
- API reference
|
||||||
- Use of popular components
|
- Self-hosting instructions
|
||||||
|
- Development and contribution guidelines
|
||||||
|
|
||||||
**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)**
|
All contributions to improve this documentation are welcome! Feel free to submit issues or pull requests to help make these docs better for everyone.
|
||||||
|
|
||||||
## Development
|
## Development & Contributing
|
||||||
|
|
||||||
Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command:
|
This documentation site is built using [Mintlify](https://mintlify.com). If you'd like to contribute to the documentation or run it locally for development, follow the instructions below.
|
||||||
|
|
||||||
```
|
### Local Development
|
||||||
|
|
||||||
|
Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally:
|
||||||
|
|
||||||
|
```bash
|
||||||
npm i -g mint
|
npm i -g mint
|
||||||
```
|
```
|
||||||
|
|
||||||
Run the following command at the root of your documentation, where your `docs.json` is located:
|
Run the following command at the root of your documentation, where your `docs.json` is located:
|
||||||
|
|
||||||
```
|
```bash
|
||||||
mint dev
|
mint dev
|
||||||
```
|
```
|
||||||
|
|
||||||
View your local preview at `http://localhost:3000`.
|
View your local preview at `http://localhost:3000`.
|
||||||
|
|
||||||
## Publishing changes
|
### Publishing Changes
|
||||||
|
|
||||||
Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
|
Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
|
||||||
|
|
||||||
## Need help?
|
### Need Help?
|
||||||
|
|
||||||
### Troubleshooting
|
#### Troubleshooting
|
||||||
|
|
||||||
- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
|
- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
|
||||||
- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
|
- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
|
||||||
|
|
||||||
### Resources
|
#### Resources
|
||||||
- [Mintlify documentation](https://mintlify.com/docs)
|
- [Mintlify documentation](https://mintlify.com/docs)
|
||||||
- [Mintlify community](https://mintlify.com/community)
|
- [Mintlify community](https://mintlify.com/community)
|
||||||
|
- [Pangolin GitHub Repository](https://github.com/fosrl/pangolin)
|
||||||
|
|||||||
Reference in New Issue
Block a user