2017-06-27 23:40:13 +02:00
# Terraform Documentation
This directory contains the portions of [the Terraform website ](https://www.terraform.io/ ) that pertain to the
core functionality, excluding providers and the overall configuration.
The files in this directory are intended to be used in conjunction with
[the `terraform-website` repository ](https://github.com/hashicorp/terraform-website ), which brings all of the
different documentation sources together and contains the scripts for testing and building the site as
a whole.
2021-07-02 18:08:00 +02:00
## Previewing Changes
2021-07-02 19:51:00 +02:00
You should preview all of your changes locally before creating a pull request. The build includes content from this repository and the [`terraform-website` ](https://github.com/hashicorp/terraform-website/ ) repository, allowing you to preview the entire Terraform documentation site. If `terraform-website` isn't in your `GOPATH` , the preview command will clone it to your machine.
2021-07-02 18:08:00 +02:00
**Set Up Local Environment**
1. [Install Docker ](https://docs.docker.com/get-docker/ ).
2021-07-02 19:49:59 +02:00
1. Create a `~/go` directory manually or by [installing Go ](https://golang.org/doc/install ).
1. Open terminal and set `GOPATH`
2021-07-02 18:16:45 +02:00
2021-07-02 18:19:28 +02:00
Bash: `export $GOPATH=~/go` (bash)
2021-07-02 18:16:45 +02:00
2021-07-02 18:19:28 +02:00
Zsh: `echo -n 'export GOPATH=~/go' >> ~/.zshrc`
2021-07-02 19:49:59 +02:00
1. Restart your terminal or command line session.
2021-07-02 18:08:00 +02:00
**Launch Site Locally**
2021-07-02 18:29:35 +02:00
1. Navigate into your local `terraform` top-level directory and run `make website` .
3. Open `http://localhost:4567` in your web browser. While the preview is running, you can edit pages and Middleman will automatically rebuild them.
2021-07-02 19:50:09 +02:00
4. When you're done with the preview, press `ctrl-C` in your terminal to stop the server.
