47 Commits (6dcf00aefc56b48bae54822a6e62eacffd2bc3ea)

Author	SHA1	Message	Date
Martin Atkins	e35c25da44	website: Try function documentation "provably" vs "probably" typo ... This paragraph is trying to say that try only works for dynamic errors and not for errors that are _not_ based on dynamic decision-making in expressions. I'm not sure if this typo was always here or if it was mistakenly "corrected" at some point, but either way the word "probably" changes the meaning of this sentence entirely, making it seem like Terraform is hedging the likelihood of a problem rather than checking exactly for one.	4 years ago
Dylan Staley	21cbb5b392	migrate docs to mdx	4 years ago
Dylan Staley	0e48f58688	Revert "migrate docs to mdx" ... This reverts commit 3cb12b5a52.	4 years ago
Dylan Staley	3cb12b5a52	migrate docs to mdx	4 years ago
Laura Pacilio	bd64d07e6b	Apply suggestions from code review	4 years ago
Laura Pacilio	b838a93023	Add cidr block output example to setproduct function page	4 years ago
Krista LaFentres	1f08f7dba8	Clarify the way the trim() function works and add some more examples	4 years ago
Laura Pacilio	73a3bb2702	Merge pull request #28334 from paultyng/patch-1 ... Add null to type conversion docs	5 years ago
Laura Pacilio	03849d850a	Merge pull request #28486 from joshschmitter/patch-1 ... setsubtract doc: use "Relative Complement" correctly	5 years ago
joshschmitter	cb41b158f1	concise use of "relative complement" ... Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>	5 years ago
Laura Pacilio	d427c81a89	Update jsonencode minified note	5 years ago
Laura Pacilio	dffb8b4a16	Merge pull request #29088 from brenthc/minify_jsonencode ... note that output of jsonencode is minified	5 years ago
Brent Woodruff	ed84cb886e	Apply suggested wording update.	5 years ago
Laura Pacilio	5863af448f	Merge pull request #28784 from TAYTS/patch-2 ... Update range.html.md	5 years ago
Laura Pacilio	d0bc382797	Merge pull request #29359 from 45deg/45deg-patch-1 ... Fix a result in examples for urlencode.html.md	5 years ago
Laura Pacilio	e1b702b8d0	Merge pull request #29417 from jonesetc/patch-1 ... Fix link to index function	5 years ago
Laura Pacilio	b574c03dd1	Merge pull request #29271 from kebroad/patch-1 ... Fixed cidrhost() example 1 and 2 with correct function parameter	5 years ago
Kyle Jones	e4e5f5a1a4	Fix link to index function ... The element function page previously linked to the index page for all functions where it meant to link to the index function page.	5 years ago
Martin Atkins	c23a7fce4e	lang/funcs: Preserve IP address leading zero behavior from Go 1.16 ... Go 1.17 includes a breaking change to both net.ParseIP and net.ParseCIDR functions to reject IPv4 address octets written with leading zeros. Our use of these functions as part of the various CIDR functions in the Terraform language doesn't have the same security concerns that the Go team had in evaluating this change to the standard library, and so we can't justify an exception to our v1.0 compatibility promises on the same sort of security grounds that the Go team used to justify their compatibility exception. For that reason, we'll now use our own fork of the Go library functions which has the new check disabled in order to preserve the prior behavior. We're taking this path, rather than pre-normalizing the IP address before calling into the standard library, because an additional normalization layer would be entirely new code and additional complexity, whereas this fork is relatively minor in terms of code size and avoids any significant changes to our own calls to these functions. Thanks to the Kubernetes team for their prior work on carving out a subset of the "net" package for their similar backward-compatibility concern. Our "ipaddr" package here is a lightly-modified fork of their fork, with only the comments changed to talk about Terraform instead of Kubernetes. This fork is not intended for use in any other future feature implementations, because they wouldn't be subject to the same compatibility constraints as our existing functions. We will use these forked implementations for new callers only if consistency with the behavior of the existing functions is a key requirement.	5 years ago
45deg	494043ed24	Fix a result in examples for urlencode.html.md	5 years ago
Kevin Broadbridge	f5cbe59386	Fixed cidrhost example 1 and 2 with correct function parameter	5 years ago
Laura Pacilio	06a2fdcf9d	Merge branch 'main' into description-metadata-language-docs	5 years ago
Laura Pacilio	a780f625e9	Fix metadata description format on all pages	5 years ago
Kristin Laemmert	563f1436eb	various docs updates (#29018) ... * website/docs: add sensitivity warning to output documentation fixes #28005 * website/docs: add note about ** to fileset documentation closes #24220 * website/docs: add note that `dynamic` expressions aren't included in json config output closes #28346 * website: the provider installer isn't necessarily concurrency safe closes #28367	5 years ago
Laura Pacilio	bc9065334e	Update description metadata per PR feedback	5 years ago
Laura Pacilio	952cb33103	Add description metadata to functions overview page	5 years ago
Brent Woodruff	3a66236c14	note that output of jsonencode is minified	5 years ago
Laura Pacilio	577c3653f2	Merge pull request #28983 from KurtLehnardt/patch-1 ... fixed typo	5 years ago
Laura Pacilio	de97a03528	Merge pull request #28908 from kondr57/patch-1 ... fix typo	5 years ago
Radek Simko	bb868606ea	docs: Document naming conventions for templates & backend configs (#28924) ... * docs: Document naming conventions for templates & backend configs * Update website/docs/cli/config/config-file.html.md Co-authored-by: Alisdair McDiarmid <alisdair@users.noreply.github.com> * Update website/docs/language/functions/templatefile.html.md Co-authored-by: Alisdair McDiarmid <alisdair@users.noreply.github.com> Co-authored-by: Alisdair McDiarmid <alisdair@users.noreply.github.com>	5 years ago
Kurt Lehnardt	165b2a2509	fixed typo	5 years ago
Kristin Laemmert	9ca3cb4233	website/docs: move type func docs to a useful location (#28940) ... * website/docs: move type func docs to a useful location * docs don't exist if you don't put them in the index (again)	5 years ago
Vladimir Kondratiev	58a5207dc4	fix typo	5 years ago
TAY TS	511011335a	Update range.html.md ... Fix the condition in the negative direction range pseudo code	5 years ago
James Bardin	760a59b3a7	negative substring	5 years ago
Steve Matney	e27a927ba4	Updating sensitive and nonsensitive docs with correct v0.15 info.	5 years ago
joshschmitter	0c4e823ee6	setsubtract doc: use "Relative Complement" correctly ... The explanation of the setsubtract function in terms of a Relative Complement is backwards. Fixing it.	5 years ago
Martin Atkins	140c613ae8	lang/funcs: "one" function ... In the Terraform language we typically use lists of zero or one values in some sense interchangably with single values that might be null, because various Terraform language constructs are designed to work with collections rather than with nullable values. In Terraform v0.12 we made the splat operator [*] have a "special power" of concisely converting from a possibly-null single value into a zero-or-one list as a way to make that common operation more concise. In a sense this "one" function is the opposite operation to that special power: it goes from a zero-or-one collection (list, set, or tuple) to a possibly-null single value. This is a concise alternative to the following clunky conditional expression, with the additional benefit that the following expression is also not viable for set values, and it also properly handles the case where there's unexpectedly more than one value: length(var.foo) != 0 ? var.foo[0] : null Instead, we can write: one(var.foo) As with the splat operator, this is a tricky tradeoff because it could be argued that it's not something that'd be immediately intuitive to someone unfamiliar with Terraform. However, I think that's justified given how often zero-or-one collections arise in typical Terraform configurations. Unlike the splat operator, it should at least be easier to search for its name and find its documentation the first time you see it in a configuration. My expectation that this will become a common pattern is also my justification for giving it a short, concise name. Arguably it could be better named something like "oneornull", but that's a pretty clunky name and I'm not convinced it really adds any clarity for someone who isn't already familiar with it.	5 years ago
Paul Tyng	b8a0929a5d	Add null to tostring docs	5 years ago
Paul Tyng	b3fe8713e8	Add null to tonumber docs	5 years ago
Paul Tyng	eb927958bd	Add null to tobool docs	5 years ago
Víctor Felipe Godoy Hernández	a9487c7674	Fix yamldecode example from json to yaml (#28220) ... * Fix yamldecode example from json to yaml * inline yaml example	5 years ago
Martin Atkins	89b2405080	lang/funcs: "sensitive" and "nonsensitive" functions ... These aim to allow hinting to Terraform about situations where it's not able to automatically infer value sensitivity. "nonsensitive" is for situations where Terraform's behavior is too conservative, such as when a new value is derived from a sensitive value in such a way that all of the sensitive content is removed. "sensitive", on the other hand, is for situations where Terraform can't otherwise infer that a value is sensitive. These situations should be pretty rare in a module that's making effective use of sensitive input variables and output values, but the documentation shows one example of an uncommon situation where a more direct hint via this function would be needed. Both of these functions are aimed at only occasional use in unusual situations. They are here for reasons of pragmatism, not because we expect them to be used routinely or recommend their use.	5 years ago
Stephen	e39abbf6f0	fix regex logical or documentation (#27637) ... * fix regex logical or documentation Co-authored-by: Kristin Laemmert <mildwonkey@users.noreply.github.com>	5 years ago
Nick Fagerlund	d1e8537b33	website: CLI: Update links to moved docs pages	5 years ago
Nick Fagerlund	7a8dd326c6	website: Language: Update links to moved pages	5 years ago
Nick Fagerlund	78dcc8dc1b	website: Language: Move files to match new URL structure	5 years ago