update examples and add 2.0.0 release announcement

Author: mschuchard

README.md

@@ -5,3 +5,9 @@ The Terraform Provider Plugin "stdlib" provides additional functions to enhance
 This README is purposefully short as all documentation is generated with `terraform-plugin-docs` and hosted at the [Terraform Registry](https://registry.terraform.io/providers/mschuchard/stdlib/latest/docs) as per usual.
 
 This repository additionally does accept feature requests for e.g. additional functions or enhancements to current functions in the Github issue tracker.
+
+### Upcoming 2.0.0 Release Announcement
+- All functions as of version 1.6.0 will be re-implemented as custom provider functions.
+- All new functions implemented after the release of version 2.0.0 will be custom provider functions only, and not data sources.
+- All data source functions that exist at the time of the release of version 1.6.0 will be maintained afterwards for any necessary bug fixes.
+- Please upgrade to Terraform version >= 1.8 by the release of version 2.1.0 to ensure support for any new functions supported by this provider.

examples/data-sources/stdlib_compare_list/data-source.tf

@@ -3,18 +3,18 @@ data "stdlib_compare_list" "lesser" {
   list_one = ["foo", "bar", "b"]
   list_two = ["foo", "bar", "baz"]
 }
-# => -1
+# result => -1
 
 # Returns a comparison between two lists.
 data "stdlib_compare_list" "equals" {
   list_one = ["pizza", "cake"]
   list_two = ["pizza", "cake"]
 }
-# => 0
+# result => 0
 
 # Returns a comparison between two lists.
 data "stdlib_compare_list" "greater" {
   list_one = ["super", "hyper", "turbo"]
   list_two = ["pizza", "cake"]
 }
-# => 1
+# result => 1

examples/data-sources/stdlib_empty/data-source.tf

@@ -2,22 +2,22 @@
 data "stdlib_empty" "list" {
   list_param = []
 }
-# => true
+# result => true
 
 # Returns whether the map is empty.
 data "stdlib_empty" "map" {
   map_param = { "foo" = "bar" }
 }
-# => false
+# result => false
 
 # Returns whether the set is empty.
 data "stdlib_empty" "set" {
   set_param = ["no"]
 }
-# => false
+# result => false
 
 # Returns whether the string is empty.
 data "stdlib_empty" "string" {
   string_param = ""
 }
-# => true
+# result => true

examples/data-sources/stdlib_equal_map/data-source.tf

@@ -3,11 +3,11 @@ data "stdlib_equal_map" "foo" {
   map_one = { "hello" = "world" }
   map_two = { "hello" = "world" }
 }
-# => true
+# result => true
 
 # Reports whether the two maps contain the same key/value pairs.
 data "stdlib_equal_map" "bar" {
   map_one = { "hello" = "world" }
   map_two = { "foo" = "bar" }
 }
-# => false
+# result => false

examples/data-sources/stdlib_exp/data-source.tf

@@ -2,10 +2,10 @@
 data "stdlib_exp" "zero" {
   param = 0
 }
-# => 1
+# result => 1
 
 # Return the base e exponential of 1.0986122
 data "stdlib_exp" "decimal" {
   param = 1.0986122
 }
-# => 2.9999997339956828
+# result => 2.9999997339956828

examples/data-sources/stdlib_flatten_map/data-source.tf

@@ -5,4 +5,4 @@ data "stdlib_flatten_map" "foo" {
     { "foo" = "bar" }
   ]
 }
-# => {"hello" = "world", "foo = "bar}
+# result => {"hello" = "world", "foo = "bar}

examples/data-sources/stdlib_has_key/data-source.tf

@@ -6,7 +6,7 @@ data "stdlib_has_key" "foo" {
   }
   key = "foo"
 }
-# => true
+# result => true
 
 # Check existence of "bar" key in map:
 data "stdlib_has_key" "bar" {
@@ -16,4 +16,4 @@ data "stdlib_has_key" "bar" {
   }
   key = "bar"
 }
-# => false
+# result => false

examples/data-sources/stdlib_has_keys/data-source.tf

@@ -7,7 +7,7 @@ data "stdlib_has_keys" "bar_foo" {
   }
   keys = ["bar", "foo"]
 }
-# => true
+# result => true
 
 # Check existence of either "bar" or "pizza" keys in map:
 data "stdlib_has_keys" "bar_pizza" {
@@ -18,20 +18,20 @@ data "stdlib_has_keys" "bar_pizza" {
   }
   keys = ["bar", "pizza"]
 }
-# => false
+# result => false
 
 # Check existence of "bar" and "foo" keys in map:
 data "stdlib_has_keys" "bar_foo_all" {
   map  = { "hello" = "world", "foo" = "bar", "baz" = "bat" }
   keys = ["bar", "foo"]
   all  = true
 }
-# => false
+# result => false
 
 # Check existence of "hello", "foo", and "baz" keys in map:
 data "stdlib_has_keys" "three_keys_all" {
   map  = { "hello" = "world", "foo" = "bar", "baz" = "bat" }
   keys = ["hello", "foo", "baz"]
   all  = true
 }
-# => true
+# result => true

examples/data-sources/stdlib_has_value/data-source.tf

@@ -6,7 +6,7 @@ data "stdlib_has_value" "foo" {
   }
   value = "foo"
 }
-# => false
+# result => false
 
 # Check existence of "bar" value in map:
 data "stdlib_has_value" "bar" {
@@ -16,4 +16,4 @@ data "stdlib_has_value" "bar" {
   }
   value = "bar"
 }
-# => true
+# result => true

examples/data-sources/stdlib_has_values/data-source.tf

@@ -7,7 +7,7 @@ data "stdlib_has_values" "foo_bar" {
   }
   keys = ["foo", "bar"]
 }
-# => true
+# result => true
 
 # Check existence of either "foo" or "pizza" keys in map:
 data "stdlib_has_values" "foo_pizza" {
@@ -18,20 +18,20 @@ data "stdlib_has_values" "foo_pizza" {
   }
   keys = ["foo", "pizza"]
 }
-# => false
+# result => false
 
 # Check existence of "foo" and "bar" values in map:
 data "stdlib_has_values" "foo_bar_all" {
   map    = { "hello" = "world", "foo" = "bar", "baz" = "bat" }
   values = ["foo", "bar"]
   all    = true
 }
-# => false
+# result => false
 
 # Check existence of "hello", "bar", and "bat" values in map:
 data "stdlib_has_values" "three_values_all" {
   map    = { "hello" = "world", "foo" = "bar", "baz" = "bat" }
   values = ["world", "bar", "bat"]
   all    = true
 }
-# => true
+# result => true