mirror of https://github.com/dapr/docs.git
60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
# Dapr documentation
|
|
|
|
If you are looking to explore the Dapr documentation, please go to the documentation website:
|
|
|
|
[**https://docs.dapr.io**](https://docs.dapr.io)
|
|
|
|
This repo contains the markdown files which generate the above website. See below for guidance on running with a local environment to contribute to the docs.
|
|
|
|
## Contribution guidelines
|
|
|
|
Before making your first contribution, make sure to review the [contributing section](http://docs.dapr.io/contributing/) in the docs.
|
|
|
|
## Overview
|
|
|
|
The Dapr docs are built using [Hugo](https://gohugo.io/) with the [Docsy](https://docsy.dev) theme, hosted on an [Azure Static Web App](https://docs.microsoft.com/en-us/azure/static-web-apps/overview).
|
|
|
|
The [daprdocs](./daprdocs) directory contains the hugo project, markdown files, and theme configurations.
|
|
|
|
## Pre-requisites
|
|
|
|
- [Hugo extended version](https://gohugo.io/getting-started/installing)
|
|
- [Node.js](https://nodejs.org/en/)
|
|
|
|
## Environment setup
|
|
|
|
1. Ensure pre-requisites are installed
|
|
2. Clone this repository
|
|
```sh
|
|
git clone https://github.com/dapr/docs.git
|
|
```
|
|
3. Change to daprdocs directory:
|
|
```sh
|
|
cd ./docs/daprdocs
|
|
```
|
|
4. Update submodules:
|
|
```sh
|
|
git submodule update --init --recursive
|
|
```
|
|
5. Install npm packages:
|
|
```sh
|
|
npm install
|
|
```
|
|
|
|
## Run local server
|
|
1. Make sure you're still in the `daprdocs` directory
|
|
2. Run
|
|
```sh
|
|
hugo server --disableFastRender
|
|
```
|
|
3. Navigate to `http://localhost:1313/docs`
|
|
|
|
## Update docs
|
|
1. Create new branch
|
|
1. Commit and push changes to content
|
|
1. Submit pull request to `master`
|
|
1. Staging site will automatically get created and linked to PR to review and test
|
|
|
|
## Code of Conduct
|
|
Please refer to our [Dapr community code of conduct](https://github.com/dapr/community/blob/master/CODE-OF-CONDUCT.md).
|