Commit Graph

5321 Commits

Author SHA1 Message Date
Martin Atkins e41883d972 website: Revise the "Output Values" configuration docs section
This adopts a more guide-like writing style, similar to what prior commits
have done to some other subsections of this section.

In the process of writing this, I identified some unclear statements in
the "Resources" subsection, and so these are also revised here for
consistency with the output values documentation.
2018-10-16 18:47:33 -07:00
Martin Atkins f8f2ff2202 website: Revise the "Input Variables" configuration docs section
This adopts a more guide-like writing style, similar to what prior commits
have done to the Resources and Providers sections.
2018-10-16 18:47:33 -07:00
Martin Atkins a6cf796873 website: Revise the "Providers" configuration docs section
These revisions reflect this sub-section's new earlier placement in the
sub-section list, leading to a more guide-like style for the initial
sections.

Also includes some minor copy-editing to align terminology with that
introduced in the prior commit for the "Resources" docs page.
2018-10-16 18:47:33 -07:00
Martin Atkins 6fa6a0d110 website: revise the "Resources" configuration docs section
This is now the leading subsection of the Configuration section of the
docs, and so this rewrite intends to make it more "guide-like" and as
accessible as possible to those who are not yet familiar with other
Terraform concepts.

This rewrite also attempts to introduce some consistency into our
vocabulary, which should eventually be reflected throughout our
documentation. In particular:

- "Resource" refers to the block the user writes in configuration, while
  "Resource _Type_" refers to what the provider defines. We previously
  used "resource" for both of these interchangeably.

- "Resource" is no longer used to refer to what gets created and managed
  in remote APIs as a result of a resource block in configuration. Lacking
  a good distinct name for these, this guide uses the word "object",
  qualifying it as "infrastructure object" or "remote object" where
  necessary to retain clarity. This distinction is important to enable
  a clear description of resource lifecycle.

- "Argument" refers to an element (attribute or block) within a resource
  block. This terminology was already being used in some places, so we
  embrace it here as a way to distinguish from "attribute", which is
  what a resource _exports_ for use in expressions.

- Since interpolation is no longer needed to use expressions in the
  language, the word "expression" is used to describe the definition of
  a value that might involve some computation. Where necessary, this is
  used with a modifier "arbitrary expression" to contrast with situations
  where the set of allowed expression constructs is constrained.
2018-10-16 18:46:46 -07:00
Martin Atkins 27429b61a9 website: Flesh out the intro to the "Configuration" section.
The prior content on this page was little more than an instruction to
begin navigating the sub-sections of this section.

The new content aims to give a broad overview of some of the language
concepts and a syntax example, in order to create some context to help
the user navigate the subsections more easily.

This also introduces for the first time usage of the term "the Terraform
language". This was previously left un-named, leading to some awkward
sentence constructions elsewhere in the docs. This new name gives us
some specific terminology to use in order to contrast the language that
exists at Terraform's level of abstraction, defining the semantics, from
the underlying grammar provided by HCL.
2018-10-16 18:46:46 -07:00
Martin Atkins e5e3452ffa website: Reorganize the "Configuration" docs section
With the additional configuration language features coming in Terraform
v0.12, our existing documentation structure is beginning to strain.

Here we reorganize the navigation slightly in order to introduce the
concepts in a more appropriate order so that we can reveal complexity
more gradually. Subsequent commits will revise the content of these
pages to better reflect the new sequencing.

The "Environment Variables" page is moved from the Configuration section
into the "Commands" section, since it is not considered a part of the
configuration language and thus more appropriate in the CLI documentation.
The old placement is reflective of the broader purpose that the
"Configuration" section had originally, but its new focus will be on
the Terraform language (.tf files) in particular, with other aspects of
customizing Terraforms behavior covered in other sections.
2018-10-16 18:46:46 -07:00
Luke Kysow 3eafbf3861 Add link to Terraform's GitHub Actions docs (#19091) 2018-10-16 10:36:04 -07:00
Sander van Harmelen 775f8a9626 Make sure we always set a custom header
This is for TFE to recognize were the calls come from.
2018-10-15 20:33:42 +02:00
cgriggs01 87191d46cd add helm links 2018-10-09 16:57:54 -07:00
cgriggs01 24c360ec8d add nutanix links 2018-10-09 14:29:52 -07:00
Chris Griggs 9463b010ed
Spelling fix! 2018-10-04 10:38:29 -07:00
cgriggs01 7119caf198 formatting 2018-10-04 10:08:25 -07:00
cgriggs01 4bee6b30e2 add community prov 2018-10-04 09:44:35 -07:00
Nick Fagerlund b3935b29d7
website: Reconcile docs about plugin discovery and downloading (#18973)
website: Reconcile docs about plugin discovery and downloading

I'm attempting to keep things simple for normal users while making sure we've
got the full behavior written down somewhere for plugin developers.

This commit doesn't stand alone; it's paired with a commit in the
terraform-website repo, to deal with some related content in the "extend"
section.
2018-10-02 16:53:29 -07:00
cgriggs01 8bce8cd72a fix typo 2018-09-27 15:58:18 -07:00
cgriggs01 009ede44e2 add community providers 2018-09-27 15:37:36 -07:00
cgriggs01 2d7b9dfcf9 add tencentclould links 2018-09-27 12:14:04 -07:00
cgriggs01 fc3148e17a add bigip links 2018-09-26 14:28:33 -07:00
Radek Simko ecac80fd8e
docs: Fix inaccurate plugin CRUD description 2018-09-20 17:18:42 +01:00
otofune 2a902fc06d
Fix proper nouns of vcs services 2018-09-20 00:26:15 +00:00
Chris Griggs 735e38916a
CamelCase! 2018-09-19 13:22:12 -07:00
Chris Griggs 08c407a468
Merge branch 'master' into cgriggs01-rightscale 2018-09-19 13:20:26 -07:00
Chris Griggs 28ef7e2d37
Update 2018-09-19 13:15:35 -07:00
Chris Griggs daf1ec607d
CamelCase 2018-09-19 13:07:48 -07:00
Chris Griggs a7e5e15dc1
CamelCase it! 2018-09-19 13:06:29 -07:00
cgriggs01 7244abd978 add rightscale provider links 2018-09-19 11:37:40 -07:00
cgriggs01 a1b08e16c3 add oci provider links 2018-09-17 08:22:30 -07:00
cgriggs01 d6acc463e5 update community providers 2018-09-14 08:10:17 -07:00
Chris Griggs 6841414632
Merge pull request #18854 from cgriggs01/netlify-release
add Netlify provider links
2018-09-13 14:01:11 -07:00
Kristin Laemmert 19f56e3cb4
Merge pull request #18829 from saravanan30erd/issue-18808
issue #18808  docs: update uuid definition - UUID is *not* in in RFC 4122 v4 format.
2018-09-13 12:30:14 -07:00
cgriggs01 43ff5e445a add Netlify provider links 2018-09-13 11:19:40 -07:00
Chris Doherty 71c79522c6 website: Add docs/internals/archiving.html to describe the archiving process. (#18831)
Add docs/internals/archiving.html to describe the archiving process.
2018-09-10 17:32:43 -07:00
saravanan palanisamy 517e28ee6e update uuid definition 2018-09-10 21:49:02 +04:00
Dave Wongillies 9190227bc0 Fix description for state mv and push sub-commands 2018-09-04 19:16:47 -07:00
HashiBook1000 d9823d7c8b add HuaweiCloud link 2018-08-31 14:40:42 -07:00
Sander van Harmelen 77b9fad7f0 backend/manta: deprecate camelcase attribute name
This change is needed (next to making it consistent as its the only attribute name that uses camelcase) because passing that attribute objectName in the update `terraform_remote_state` resource, ended up giving me this error: https://github.com/hashicorp/terraform/blob/master/helper/schema/schema.go#L736
2018-08-29 20:22:04 +02:00
Paul Hinze cf8516287e
website: Classify remote backends as a preview release 2018-08-24 17:10:46 -05:00
Alexis Grant 6e5259911e
PTFE not ready for use with this remote version 2018-08-24 13:10:28 -07:00
Nick Fagerlund 4612a71414 website: revise docs for remote backend and credentials config 2018-08-22 14:30:23 -07:00
Phillip Wong 6b89588154
Correction of spelling for 'Keboola' provider
I also switched it around with the Kafka link to preserve the alphabetical ordering of the page.
2018-08-18 08:41:59 -07:00
Paul Hinze 6cdc464341
Initial draft of Core Workflow Guide 2018-08-17 17:18:53 -05:00
HashiBook1000 c612953a72 add community providers, remove Atlas links 2018-08-17 11:33:09 -07:00
Paul Tyng d0fec98833
Merge pull request #18647 from hashicorp/paultyng-patch-1
Clarifying the language around "root outputs"
2018-08-17 09:27:05 -04:00
Chris Griggs 4bbf303f72
Update infra-index.html.markdown 2018-08-14 14:00:06 -07:00
HashiBook1000 3a75b28626 swap tfe v2 links with Atlas 2018-08-14 13:35:37 -07:00
Sander van Harmelen bb37637a13
Merge pull request #18642 from hashicorp/f-remote-backend
backend/remote: do not use the TFE_TOKEN env variable
2018-08-10 20:32:07 +02:00
Sander van Harmelen 7049d973a9 Do not use the TFE_TOKEN env variable
Instead promote the use of shared credentials using the CLI Config File
2018-08-10 20:20:16 +02:00
HashiBook1000 fc6671e191 fix ACME link and add community providers 2018-08-09 13:16:34 -07:00
Paul Tyng 22bdc44cb1
Clarifying the language around "root outputs" 2018-08-09 13:20:45 -04:00
HashiBook1000 8042a96ff7 update master with provider links 2018-08-06 16:14:37 -07:00
Sander van Harmelen 7fb2d1b8de Implement the Enterprise enhanced remote backend 2018-08-03 22:22:55 +02:00
Nick Fagerlund 2487af1945 website: atlas backend requires https protocol in address (#18585)
Just providing the hostname won't work. This commit adds an example and fixes
the explanation.
2018-08-01 17:33:11 -07:00
Phillip Wong 6699321802
Update community-index.html.markdown
Corrected the naming of the 'Keboola' provider and shifted it down to keep alphabetical ordering.
2018-07-31 15:44:19 -07:00
Martin Atkins 15ad2e4f9e website: Revise the "Module Sources" page
It's been a while since we made any significant updates to this page.
The main theme of this revamp is to ensure that we highlight how to
provide "ambient credentials" for each of the module sources using the
standard mechanisms for each source type.

While there, I also attempted a general cleanup to highlight the main
cases and make this less like a detailed description of all of
go-getter's esoteric features, and did some general copy-editing to write
it in our usual documentation "voice".
2018-07-31 10:11:36 -07:00
Clint Shryock 26b68d98f9 update some content to reference the extending terraform section 2018-07-26 10:37:36 -05:00
Alexis Grant c97a4246ff website: update module creation docs to link to version constraint info 2018-07-25 16:05:44 -07:00
Marv Cool 1a14ec8bd6 website: fix curl example for registry API 2018-07-25 09:11:54 -07:00
Michał Kiełtyka 8add05f6ee website: Remove errant "the" in the running-in-automation guide 2018-07-25 09:08:38 -07:00
Kristin Laemmert 419649d4f0
Merge pull request #18516 from xulsitatirev/patch-2
Fix documentation on tainting resources within modules
2018-07-23 09:39:37 -07:00
Sitatirev, Xul ad9e32f1f4
Fix documentation
It looks like the output does not match the command, in fact.
This pull-request fixes this issue.
2018-07-22 23:59:53 +02:00
Erich bca20a1792
Update database-index.html.markdown
Fix repeated word "with with"
2018-07-22 16:48:04 +01:00
Johannes Liebermann 6a493f37d3
Update running-terraform-in-automation.html.md
Fix word ordering
2018-07-12 16:12:18 +02:00
Nick Fagerlund a51fc61014 website: Revise "atlas" backend page
Add links to important docs (like user tokens), and explain that this isn't part
of our recommended primary workflows anymore.
2018-07-09 15:28:30 -07:00
Cory Lucas 5fda3a3b12 website: Update leftover references to "environment" rather than "workspace" 2018-07-05 16:31:14 -07:00
Martin Atkins 9441e78fb9 website: v0.12 preview upgrade guide tweaks
Based on some feedback on the initial draft, make some minor updates to
how information is presented in the preview upgrade guide for v0.12.

This also includes some minor copy-editing work to try to make the "voice"
more consistent between different sections of the guide.
2018-06-29 11:17:17 -07:00
Yevgeniy Brikman b44932d8fe website: Simplify the Getting Started consul module example
This module now gets the region from the inherited provider block.
2018-06-28 18:10:55 -07:00
James Bardin 32e3179de9
Merge pull request #18350 from KFishner/master
Add 0.12 upgrade guide
2018-06-28 11:47:11 -04:00
Martin Atkins d4ac68423c website: Tweak the language we use to describe remote state
After some discussion with "iamakulov" on Twitter it seems that the use
of the word "conflicts" and "merge conflicts" here was sounding like us
implicitly condoning the use of version control as a mechanism for
distributing local state files, which hasn't been recommended for quite
some time since remote state now provides a much more robust solution.

While here, I also tweaked some other language on this page for style and
for use of terminology we more commonly use in our more recent
documentation.
2018-06-26 11:43:36 -07:00
kfishner 6deec5d7bf add 0.12 guide 2018-06-25 17:26:45 -07:00
Thomas Kula e2373c8073 website: Using demo.consul.io requires scheme = "https"
Following the examples as they were previously would cause errors
accessing demo.consul.io. Now we consistently set the scheme to https for
all examples that use demo.consul.io.

This also includes some other updates to the URLs, since the Consul demo
has been rebuilt with a different based configuration, and some general
formatting and copyediting changes in the Consul example.
2018-06-22 10:18:27 -07:00
Kieran Spear fa5d9cc2ca website: Fix spelling mistake (#18311) 2018-06-22 07:31:23 -07:00
Chris Griggs 3b2f747006
Update major-index.html.markdown 2018-06-19 11:54:25 -07:00
Chris Griggs ac27d7deb9
Update index.html.markdown 2018-06-19 11:54:07 -07:00
Chris 2e9aed6d2b Add AzureStack documentation links 2018-06-18 11:40:21 -07:00
Quinn Diggity c943caf1a5 website: fix for typo in resources.html.md (#18266)
should be provides, not provies
2018-06-18 08:37:57 -07:00
Quinn Diggity b2df1d424f website: fixes typo (#18267)
should be maximum not maxiumum
2018-06-18 08:36:28 -07:00
Paddy 931f8ecc41 Fix broken links to /docs/enterprise/run/api.html
We had a couple broken links pointing to the docs for the run API. This
updates them to the new location.
2018-06-13 12:19:07 -07:00
cabillman 3dc1ce3036 docs: Fix small error in resource targeting docs (#17890) 2018-06-11 12:34:25 -07:00
Peter Hoeg Steffensen 8a5cedaae6 Docs: syntax fix - Removed quotation marks (#18136)
The example for parsing multiple providers to a module had quotation marks around the keys. This does not seem to be the correct format
2018-06-11 12:08:23 -07:00
Jaye Doepke 596c7b2638 docs typo 2018-06-11 12:04:03 -07:00
SpencerBrown 3324de35b6 Fix typo in doc: "The support operators are" -> "The supported operators are" 2018-06-11 11:50:18 -07:00
Ben Turner 1de8d171ae Small typo fix 2018-06-11 11:47:54 -07:00
nicklathe e552897c52 Fix typo (wit -> with) for etcdv3 backend docs 2018-06-11 11:46:17 -07:00
Chris fba58d3a04 add provider documentation links 2018-06-05 16:09:30 -07:00
Chris f80aca5d98 add flexibleengine provider documentation links 2018-05-31 15:35:55 -07:00
Chris c294fd7f1f remove runscope links 2018-05-31 11:22:56 -07:00
Chris fbb0c88c21 add runscope provider links 2018-05-29 16:18:33 -07:00
Alexis Grant 170a1530d1 website: Example of the Git+SSH protocol for bitbucket module sources 2018-05-24 15:32:19 -07:00
Chris ddf5e581ca add Nutanix 2018-04-30 11:04:59 -07:00
Chris 1c781d7b9e add a few community providers 2018-04-30 09:52:57 -07:00
Walter Dolce b60501290c
Make "v3" in etcd visible in the backend types sidebar 2018-04-25 15:20:56 +01:00
Kevin Faulkner b39ec8b6ff
fix incorrect url
switch guthub with github global
2018-04-21 15:56:42 -04:00
Emil Nikolov 8d3bcd4f87 website: Fix repetition of "directly" in file provisioner docs 2018-04-16 16:27:52 -07:00
Chris Griggs 05291ab982
Merge pull request #17845 from cgriggs01/d-add-com-prov
Website: add two community providers
2018-04-12 09:43:20 -07:00
Chris 74c62b62b6 add two community providers 2018-04-11 16:26:28 -07:00
Clint 76974209ec
Update guides.erb
Update "Writing Custom Providers" guide link to new Extend section
2018-04-09 15:11:59 -05:00
Chris Griggs b0f0dd2795
fix typo 2018-04-09 11:06:06 -07:00
Chris Griggs 3ab13fefad
Fix typo 2018-04-09 11:05:36 -07:00
Chris 36539f1a25 add VMware NSX-T links to provider index pages 2018-04-09 10:52:57 -07:00
Dominik-K 9da5f5a9f0 docs: no interpolations in `lifecycle` attribute (#3116) (#17695)
* docs: interpolations in `lifecycle` unsupported currently
2018-04-05 15:06:22 -04:00