terraform/website/intro/vs
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
..
boto.html.markdown website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00
chef-puppet.html.markdown website: Don't claim that things are "very easy" 2020-10-26 10:02:38 -07:00
cloudformation.html.markdown website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00
custom.html.markdown website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00
index.html.markdown website: new filesystem layout for core/provider split 2017-06-13 11:25:32 -07:00