terraform/website/docs/internals
Martin Atkins ddf9635af6 website: Don't claim that things are "very easy"
We typically try to avoid making subjective, boasty claims in our
documentation in recent times, but there remained both some older
documentation that we've not recently revised and also some newer examples
that are, in retrospect, also perhaps more "boasty" than they need to be.

We prefer not to use this sort of boasty language because not everyone
using Terraform has the same background and experience, and so what is
"easy" or "intuitive" to one person may not be so to another person, and
that should not suggest that the second person is in any way wrong or
inadequate.

In reviewing some of our use of the word "easy" here I tried as much as
possible to surgically revise the existing content without getting drawn
into a big rewrite, but in some cases the content was either pretty
unsalvageable (due to talking about obsolete features that were removed
long ago) or required some broader changes to make the result hopefully
still get the same facts across. In those cases I've both removed some
content entirely or adjusted larger paragraphs.

This was not an exhaustive review and so I'm sure there's still plenty of
room for similar improvements elsewhere. I also resisted the urge to
update some pages that contain outdated information about currently-active
features.
2020-10-26 10:02:38 -07:00
..
archiving.html.md website: Add docs/internals/archiving.html to describe the archiving process. (#18831) 2018-09-10 17:32:43 -07:00
credentials-helpers.html.md website: Credentials helper response for no creds 2020-09-15 09:00:44 -04:00
debugging.html.md logging env variable docs 2020-10-23 12:46:32 -04:00
graph.html.md website: don't talk about graphs in the Getting Started guide 2017-09-11 11:09:11 -07:00
index.html.md website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00
json-format.html.md Fix JSON output format documentation 2020-06-13 02:04:50 -04:00
lifecycle.html.md website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00
login-protocol.html.markdown website: Documentation for the "terraform login" command (#22727) 2020-02-04 11:30:40 -05:00
module-registry-protocol.html.md website: Fix several broken links (#25808) 2020-08-11 15:24:51 -07:00
provider-meta.html.md website: Configuration Language navigation refactoring 2020-06-18 09:31:52 -07:00
provider-network-mirror-protocol.html.md internal/getproviders: HTTPMirrorSource implementation 2020-08-26 13:18:08 -07:00
provider-registry-protocol.html.md Website: 0.13 docs edits, mostly around provider requirements (#25686) 2020-07-30 21:07:36 -07:00
remote-service-discovery.html.md website: Separate docs for the module registry protocol 2020-06-11 09:32:39 -07:00
resource-addressing.html.markdown update addressing section 2020-04-13 12:13:18 -04:00