Skip to content

Commit

Permalink
Update README with devcontainer
Browse files Browse the repository at this point in the history
Signed-off-by: Marc Duiker <[email protected]>
  • Loading branch information
marcduiker committed Jan 5, 2024
1 parent ad0eedb commit f77ab84
Showing 1 changed file with 32 additions and 10 deletions.
42 changes: 32 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,20 +29,43 @@ The Dapr docs are built using [Hugo](https://gohugo.io/) with the [Docsy](https:

The [daprdocs](./daprdocs) directory contains the hugo project, markdown files, and theme configurations.

## Pre-requisites
## Setup with a devcontainer

- [Hugo extended version](https://gohugo.io/getting-started/installing)
- [Node.js](https://nodejs.org/en/)
This repository comes with a [devcontainer](/.devcontainer/devcontainer.json) configuration that will automatically install all the required dependencies and tools to build and run the docs.

## Environment setup
This devcontainer can be used to develop locally with VSCode or via GitHub Codespaces completely in the browser.

1. Ensure pre-requisites are installed
2. Clone this repository
### Pre-requisites

- [Docker Desktop](https://www.docker.com/products/docker-desktop)
- [VSCode](https://code.visualstudio.com/download)

### Environment setup

1. [Fork](https://github.com/dapr/docs/fork) and clone this repository.

2. Open the forked repository in VS Code

```sh
git clone https://github.com/dapr/docs.git
code .
```

3. When prompted, click "Reopen in Container" to open the repository in the devcontainer.

Continue with the [Run local server](#run-local-server) steps.

## Setup without a devcontainer

### 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. [Fork](https://github.com/dapr/docs/fork) and clone this repository.

3. Change to daprdocs directory:

```sh
Expand All @@ -63,7 +86,7 @@ npm install

## Run local server

1. Make sure you're still in the `daprdocs` directory
1. Make sure you're in the `daprdocs` directory
2. Run

```sh
Expand All @@ -72,10 +95,9 @@ hugo server

3. Navigate to `http://localhost:1313/`


## Update docs

1. Fork repo into your account
1. Ensure you are in your forked repo
1. Create new branch
1. Commit and push changes to forked branch
1. Submit pull request from downstream branch to the upstream branch for the correct version you are targeting
Expand Down

0 comments on commit f77ab84

Please sign in to comment.