Merge pull request #1346 from hashicorp/docs-improvements

providers/heroku: Documentation improvements

website/source/docs/providers/heroku/index.html.markdown

@@ -33,6 +33,8 @@ resource "heroku_app" "default" {
 
 The following arguments are supported:
 
-* `api_key` - (Required) Heroku API token
-* `email` - (Required) Email to be notified by Heroku
+* `api_key` - (Required) Heroku API token. It must be provided, but it can also
+  be sourced from the `HEROKU_API_KEY` environment variable.
+* `email` - (Required) Email to be notified by Heroku. It must be provided, but
+  it can also be sourced from the `HEROKU_EMAIL` environment variable.
 

website/source/docs/providers/heroku/r/addon.html.markdown

@@ -19,6 +19,12 @@ resource "heroku_app" "default" {
     name = "test-app"
 }
 
+# Create a database, and configure the app to use it
+resource "heroku_addon" "database" {
+  app = "${heroku_app.default.name}"
+  plan = "heroku-postgresql:hobby-basic"
+}
+
 # Add a web-hook addon for the app
 resource "heroku_addon" "webhook" {
     app = "${heroku_app.default.name}"

website/source/docs/providers/heroku/r/app.html.markdown

@@ -17,6 +17,7 @@ create and manage applications on Heroku.
 # Create a new Heroku app
 resource "heroku_app" "default" {
     name = "my-cool-app"
+    region = "us"
 
     config_vars {
         FOOBAR = "baz"