Terraform Documentation Generator/Sync
Project description
# tf-vardoc
## Important Note
This is a _work-in-progress_! It still needs to be "productionalized" by making it into a proper commandline utility.
## What is this?
This is a utility for generating documentation regarding [Terraform](https://github.com/hashicorp/terraform)
variables.
## Why is that important?
1. The only thing worse than _no documentation_ is _stale/incorrect documentation_.
2. A part of defining Terraform variables is self-documentatin; you set variable types, descriptions, and defaults as code.
3. While you could just _read the code_, it's good practice to include a `README.md` for any Terraform module.
4. This is now a problem if you like to make purdy, stylized `README`s; there's no easy/quick way to transform your
variable definitions to documentation.
*Until now...*
## How do I use it?
Create a `README.md.j2` [jinja2 template](http://jinja.pocoo.org/docs/2.9/). Your variables will be available under
the `variables` variable. Stylize to your hearts content.
## TODO
- make this a proper commandline tool with args and configuration
- setup pip package
- distribute
## Important Note
This is a _work-in-progress_! It still needs to be "productionalized" by making it into a proper commandline utility.
## What is this?
This is a utility for generating documentation regarding [Terraform](https://github.com/hashicorp/terraform)
variables.
## Why is that important?
1. The only thing worse than _no documentation_ is _stale/incorrect documentation_.
2. A part of defining Terraform variables is self-documentatin; you set variable types, descriptions, and defaults as code.
3. While you could just _read the code_, it's good practice to include a `README.md` for any Terraform module.
4. This is now a problem if you like to make purdy, stylized `README`s; there's no easy/quick way to transform your
variable definitions to documentation.
*Until now...*
## How do I use it?
Create a `README.md.j2` [jinja2 template](http://jinja.pocoo.org/docs/2.9/). Your variables will be available under
the `variables` variable. Stylize to your hearts content.
## TODO
- make this a proper commandline tool with args and configuration
- setup pip package
- distribute
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tfvardoc-0.1.1.tar.gz
(4.0 kB
view details)
File details
Details for the file tfvardoc-0.1.1.tar.gz.
File metadata
- Download URL: tfvardoc-0.1.1.tar.gz
- Upload date:
- Size: 4.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3709e7cdf49654d23d7f702552e8dba3f9902b74725d320ff8058e7594b22413
|
|
| MD5 |
9e7dbea238573e2828da31678e76c8b2
|
|
| BLAKE2b-256 |
25a34e4e7bed6d0e600e5848493879463719b8862f75dc7b0a953baefd745056
|