Skip to main content

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

Project details


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)

Uploaded Source

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

Hashes for tfvardoc-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3709e7cdf49654d23d7f702552e8dba3f9902b74725d320ff8058e7594b22413
MD5 9e7dbea238573e2828da31678e76c8b2
BLAKE2b-256 25a34e4e7bed6d0e600e5848493879463719b8862f75dc7b0a953baefd745056

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page