mirror of
https://github.com/opentofu/opentofu.git
synced 2025-01-11 00:22:32 -06:00
5a161c8bcc
Signed-off-by: ollevche <ollevche@gmail.com> Signed-off-by: Oleksandr Levchenkov <ollevche@gmail.com>
40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# OpenTofu Documentation
|
|
|
|
This directory contains the portions of [the OpenTofu website](https://opentofu.org) that pertain to the core functionality, excluding providers and the overall configuration.
|
|
|
|
## Development server
|
|
|
|
You can start a local development server with Docker by running the following command from this (the `website`) directory:
|
|
|
|
```
|
|
docker compose up --build
|
|
```
|
|
|
|
The development server will be available on http://localhost:3000/ .
|
|
|
|
## Suggesting Changes
|
|
|
|
You can [submit an issue](https://github.com/opentofu/opentofu/issues/new/choose) with documentation requests or submit a pull request with suggested changes.
|
|
|
|
Click **Edit this page** at the bottom of any OpenTofu website page to go directly to the associated markdown file in GitHub.
|
|
|
|
## Modifying Sidebar Navigation
|
|
|
|
You must update the sidebar navigation when you add or delete documentation .mdx files. If you do not update the navigation, the website deploy preview fails.
|
|
|
|
To update the sidebar navigation, you must edit the appropriate `nav-data.json` file. This repository contains the sidebar navigation files for the following documentation sets:
|
|
|
|
- OpenTofu Language: [`language-nav-data.json`](https://github.com/opentofu/opentofu/blob/main/website/data/language-nav-data.json)
|
|
- OpenTofu CLI: [`cli-nav-data.json`](https://github.com/opentofu/opentofu/blob/main/website/data/cli-nav-data.json)
|
|
- Introduction to OpenTofu: [`intro-nav-data.json`](https://github.com/opentofu/opentofu/blob/main/website/data/intro-nav-data.json)
|
|
|
|
## Previewing Changes
|
|
|
|
Currently, you can preview your changes through the [opentofu/opentofu.org](https://github.com/opentofu/opentofu.org/blob/main/README.md) repository.
|
|
|
|
Follow the [Getting Started](https://github.com/opentofu/opentofu.org/blob/main/README.md#getting-started) guide.
|
|
|
|
## Copyright headers for code examples
|
|
|
|
In order to not include copyright headers for code examples used in docs, please, add the files under `examples` folder. This way, it will be ignored on automated copyright headers check.
|