237 Commits (cd2ba6ca460769e844e8eb689dfdee97011f6bc1)

Author	SHA1	Message	Date
Martin Atkins	67311f73fd	website: Draw better attention to for and for_each patterns ... When helping folks in the community forum, I commonly see questions around more complex patterns in transforming deep data structures into different shapes to work with for_each. We have examples of these patterns in the docs for the functions that they rely on, but they were not previously very discoverable in the main configuration language documentation sections. Here I've moved the "Using Expressions in for_each" subsection on the Resources page above some of the other sub-sections to hopefully make it easier to see, and written out in more detail the two specific patterns that answer a significant number of for_each-related user questions in the hope that readers will be more likely to realize that the links are relevant to what their goals. I also added some more elaboration about the behavior of converting from list to set in the "Using Sets" subsection, because this feature is often a user's first encounter with the set data type and I've inferred from some of the questions I've answered that a number of Terraform users don't have prior experience with set data types in other languages to draw assumptions from. Finally, I added some similar links to the for_each patterns within the for expression documentation itself, to try to make those examples more visible to those who might be discovering the documentation in a different sequence, e.g. by following a deep link shared in an answer to a question in the community forum.	6 years ago
James Bardin	866449a78a	Merge pull request #25069 from hashicorp/jbardin/depends-on-docs ... depends_on doc updates	6 years ago
Martin Atkins	d1bc412220	configs: Custom variable validation is no longer experimental ... All of the feedback from the experiment described enhancements that can potentially be added later without breaking changes, so this change simply removes the experiment gate from the feature as originally implemented with no changes to its functionality. Further enhancements may follow in later releases, but the goal of this change is just to ship the feature exactly as it was under the experiment. Most of the changes here are cleaning up the experiment opt-ins from our test cases. The most important parts are in configs/experiments.go and in experiments/experiment.go .	6 years ago
James Bardin	5d64029275	depends_on doc updates ... Update depends_on for modules and data sources.	6 years ago
Garron Kramer	f3db1232a0	Update modules.html.md ... the -module option is no longer present.	6 years ago
Daniel Dreier	44e3d99409	Merge pull request #24659 from hashicorp/timestamp-doc ... specify that `timestamp` returns UTC	6 years ago
Daniel Dreier	5e35dedc2a	Update website/docs/configuration/functions/timestamp.html.md ... Co-authored-by: Matthew Sanabria <24284972+sudomateo@users.noreply.github.com>	6 years ago
Daniel Dreier	5f80f6d49d	Merge pull request #24771 from bradleypmartin/issue-24198-update-docs-for-map-type ... Update maps docs to reflect v0.12 colon behavior	6 years ago
Daniel Dreier	5ef80b35e3	Merge pull request #24996 from pcleddy/foreach_with_toset_and_list ... Example of for_each with list -> set using toset	6 years ago
Pam Selle	bfbdb4cb1d	Add docs for provider limitations when expanding modules (#25007) ... * Add docs for provider limitations when expanding modules	6 years ago
Paul Leddy	3d17c87698	Example of for_each with list -> set using toset	6 years ago
Jean Dupouy	a54bb124a9	website/docs: provider aliases in the JSON format ... Fixes #24889	6 years ago
Robin Norwood	af5c425360	website: Add link to new learn track in configuration/modules.html (#24847)	6 years ago
Daniel Dreier	7aa97f415d	Fix "additoinal" typo in web site ... Fixes 24769	6 years ago
bradleypmartin	0b45a3c83d	Update maps docs to reflect v0.12 colon behavior	6 years ago
Martin Atkins	c6cbbcb79a	website: Initial documentation for provider_installation in the CLI config ... This is an initial draft of documentation for this new feature of the CLI configuration. This is mainly intended as a placeholder for now, because there are other documentation updates pending for the new provider namespacing and installation scheme and we'll likely want to revise these docs to better complement the broader documentation once it's written.	6 years ago
Noah Mercado	d4d8812afa	Feature: Sum Function (#24666) ... The sum function takes a list or set of numbers and returns the sum of those numbers.	6 years ago
Namho Kim	9cc658b491	specify that `timestamp` returns UTC	6 years ago
Pam Selle	ab101f99df	Merge pull request #24635 from hashicorp/pselle/docs-mod-count ... Docs for count/for_each on modules	6 years ago
Pam Selle	608c17d518	Update providers block notes	6 years ago
Fred	76f583ac9f	website/docs: fix broken hcl json spec link (#24630)	6 years ago
Pam Selle	65c4ba9c85	First docs for count/for_each on modules	6 years ago
Eduard Tamsa	534ba630e4	docs(flatten): Fix typos (#24492)	6 years ago
Adam Leskis	4f85a1a6ba	website: fix simple typo (#24415)	6 years ago
Paddy	e6592dc710	Add support for provider metadata to modules. (#22583) ... Implement a new provider_meta block in the terraform block of modules, allowing provider-keyed metadata to be communicated from HCL to provider binaries. Bundled in this change for minimal protocol version bumping is the addition of markdown support for attribute descriptions and the ability to indicate when an attribute is deprecated, so this information can be shown in the schema dump. Co-authored-by: Paul Tyng <paul@paultyng.net>	6 years ago
Martin Atkins	67d95b97ce	lang/funcs: templatefile requires valid variable names ... Previously the templatefile function would permit any arbitrary string as a variable name, but due to the HCL template syntax it would be impossible to refer to one that isn't a valid HCL identifier without causing an HCL syntax error. The HCL syntax errors are correct, but don't really point to the root cause of the problem. Instead, we'll pre-verify that the variable names are valid before we even try to render the template, and given a specialized error message that refers to the vars argument expression as the problematic part, which will hopefully make the resolution path clearer for a user encountering this situation. The syntax error still remains for situations where all of the variable names are correct but e.g. the user made a typo referring to one, which makes sense because in that case the problem _is_ inside the template.	6 years ago
James Bardin	4185aa93f5	doc typo	6 years ago
James Bardin	a765d69fb0	Merge pull request #24032 from hashicorp/jbardin/map-funcs ... make the merge function more precise	6 years ago
James Goodhouse	25bfe7337b	lang: add setsubtract function (#23424) ... * add setdifference and setsubtract functions and docs * remove setdifference as it is not implemented correct in underlying lib * Update setintersection.html.md * Update setproduct.html.md * Update setunion.html.md	6 years ago
Nick Fagerlund	6494591ec1	website: Remove extra copy of "Getting Started", update links ... This guide now lives at: - https://learn.hashicorp.com/terraform#getting-started ...and terraform.io has been redirecting to there for quite a while. This commit removes the extra copy so that the text of the two versions doesn't drift, and updates existing links to point to the new location.	6 years ago
James Bardin	529271e0be	update merge docs to match behavior	6 years ago
Pam Selle	4e0879c486	Document for_each key requirements	6 years ago
Pam Selle	213189c3d0	Use a real resource	6 years ago
Pam Selle	885ff69c50	Update docs to generalize/use fake example vs one that could be misleading	6 years ago
Kristin Laemmert	4c221cbcb9	website: document optional syntax for required_providers setting (#23854)	6 years ago
ZMI-RyanMann	66411b5ca0	website/docs: Updated documentation for range function pseudocode (#23823)	6 years ago
Martin Atkins	ff4ea042c2	config: Allow module authors to specify validation rules for variables ... The existing "type" argument allows specifying a type constraint that allows for some basic validation, but often there are more constraints on a variable value than just its type. This new feature (requiring an experiment opt-in for now, while we refine it) allows specifying arbitrary validation rules for any variable which can then cause custom error messages to be returned when a caller provides an inappropriate value. variable "example" { validation { condition = var.example != "nope" error_message = "Example value must not be \"nope\"." } } The core parts of this are designed to do as little new work as possible when no validations are specified, and thus the main new checking codepath here can therefore only run when the experiment is enabled in order to permit having validations.	6 years ago
Martin Atkins	02576988c1	lang: "try" and "can" functions ... These are intended to make it easier to work with arbitrary data structures whose shape might not be known statically, such as the result of jsondecode(...) or yamldecode(...) of data from a separate system. For example, in an object value which has attributes that may or may not be set we can concisely provide a fallback value to use when the attribute isn't set: try(local.example.foo, "fallback-foo") Using a "try to evaluate" model rather than explicit testing fits better with the usual programming model of the Terraform language where values are normally automatically converted to the necessary type where possible: the given expression is subject to all of the same normal type conversions, which avoids inadvertently creating a more restrictive evaluation model as might happen if this were handled using checks like a hypothetical isobject(...) function, etc.	6 years ago
Pam Selle	76831793d0	Merge pull request #23265 from lucazz/update_docs_for_outputs ... Update Output values docs	6 years ago
Pam Selle	3bcea18d1c	Update outputs.html.md	6 years ago
Pam Selle	31b56207e0	Update outputs.html.md	6 years ago
Igor Vodka	be89975667	Fix markdown being misused in docs	6 years ago
Martin Atkins	bfbd00a23c	website: Note about using jsonencode/yamlencode in templatefile ... It's a common source of errors to try to produce JSON or YAML syntax using string concatenation via our template language but to miss some details like correct string escaping, quoting, required commas, etc. The jsonencode and yamlencode functions are a better way to generate JSON and YAML, but it's not immediately obvious that both of these functions are available for use in external templates (via templatefile) too. Given that questions related to this come up a lot in our community forum and elsewhere, it seems worth having a documentation section to show the pattern of having a template that consists only of a single function call.	6 years ago
Graham Davison	e32641c9ce	website/docs: Corrects function name in `cidrsubnets` function documentation (#23473)	6 years ago
George Christou	91100c003c	lang/funcs: Add more `trim*` functions (#23016) ... * lang/funcs: Add `trim*` functions	7 years ago
Yuki Ito	72c910cebc	website: Fix typographical errors in the docs for base64sha256/512	7 years ago
Lucas do Amaral Saboya	806397803c	Update Output values docs.	7 years ago
Martin Atkins	f8a32f0b83	website: Consistently recommend the required_providers block ... Previously we were inconsistent in whether we were recommending the new required_providers block or the "version" setting inside a "provider" block.	7 years ago
Martin Atkins	7c110f9cf8	website: provider version constraints in modules	7 years ago
Thomas Alton	ddd0d2a442	website: Provider proxy config only supports alias	7 years ago