terraform/website/docs
Martin Atkins 6bb9fa7341 website: Document alternatives to terraform_remote_state
For some time now we've been recommending explicitly passing data between
configurations using separate resource types and data sources, rather than
always using terraform_remote_state, for reasons including reducing
coupling between subsystems and allowing a configuration's state snapshots
to be under restrictive access controls.

However, those recommendations have so far not appeared directly in the
documentation for terraform_remote_state, and have instead just been
alluded to elsewhere in the documentation when discussing ways to pass
data between configurations.

This change, then, is an attempt to be clear and explicit about the
recommendation and to give a variety of specific examples of how to
implement it. The terraform_remote_state data source page is admittedly
not the most obvious place in the information architecture to put a set
of alternatives to it, but it does appear that this documentation page is
where people most commonly end up when researching options in this area
and so I've put this here in an attempt to "meet people where they are".

Possibly in a future documentation reorganization we might have an
separate page specifically about sharing data between configurations, but
we don't currently have time to do that bigger reorganization. If we do so
later, the content on this page could potentially be replaced with a
summary of the recommendation and a link to another place for the details,
but the goal here is to make this information visible in the existing
location people look for it, rather than blocking until there's a better
place for it to live.

This also includes a small amount of editing of some existing content on
the page to use terminology and style more similar to how our main
configuration language documentation is written,.
2020-11-17 09:41:54 -08:00
..
backends Merge pull request #26723 from hashicorp/oct20_language_and_cli_docs 2020-11-11 19:31:05 -08:00
cli Merge pull request #26723 from hashicorp/oct20_language_and_cli_docs 2020-11-11 19:31:05 -08:00
commands Add a missing new line 2020-11-16 16:08:55 +01:00
configuration lang/funcs: Experimental "defaults" function 2020-11-13 17:27:20 -08:00
configuration-0-11 website: Adopt a ton of pages into the "language" layout 2020-10-26 18:19:26 -07:00
import website: Update all Learn crosslinks (#26442) 2020-10-02 11:02:59 -07:00
internals website: Fix inconsistencies in the registry protocol page 2020-11-16 10:06:27 -08:00
modules Fix grammar 2020-11-13 11:28:13 -05:00
plugins website: Make most of /docs/plugins into ghost pages on Extend 2020-10-26 18:21:29 -07:00
providers website: Document alternatives to terraform_remote_state 2020-11-17 09:41:54 -08:00
provisioners communicator/ssh: Add support for Windows targets (#26865) 2020-11-12 10:00:48 -05:00
registry Merge pull request #26723 from hashicorp/oct20_language_and_cli_docs 2020-11-11 19:31:05 -08:00
state Merge pull request #26723 from hashicorp/oct20_language_and_cli_docs 2020-11-11 19:31:05 -08:00
cli-index.html.md website: Add new "glue"/overview pages for CLI and language docs 2020-11-11 19:13:23 -08:00