.. | ||
docs | ||
guides | ||
intro | ||
layouts | ||
upgrade-guides | ||
README.md |
Terraform Documentation
This directory contains the portions of the Terraform website 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, which brings all of the
different documentation sources together and contains the scripts for testing and building the site as
a whole.
Previewing Changes
You should preview all of your changes locally before creating a pull request. The build includes content from this repository and the 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.
Set Up Local Environment
-
Create a
~/go
directory manually or by installing Go. -
Open terminal and set
GOPATH
as an environment variable:Bash:
export $GOPATH=~/go
(bash)Zsh:
echo -n 'export GOPATH=~/go' >> ~/.zshrc
-
Restart your terminal or command line session.
Launch Site Locally
- Navigate into your local
terraform
top-level directory and runmake website
. - Open
http://localhost:4567
in your web browser. While the preview is running, you can edit pages and Middleman will automatically rebuild them. - When you're done with the preview, press
ctrl-C
in your terminal to stop the server.