Remove links to source code and make examples generic in migrating - attributes & blocks - validators predefined (#418)

Author: bendbennett

website/docs/plugin/framework/migrating/attributes-blocks/validators-predefined.mdx

@@ -10,7 +10,7 @@ description: >-
 -> **Note:** The Plugin Framework is in beta.
 
 Attribute validators ensure that attributes do or do not contain specific values. You can use predefined validators for
-many use cases, or implement custom validators. Refer to [Schemas - Validators](/plugin/framework/schemas#validators) in
+many use cases, or implement custom validators. Refer to [Schemas - Validators](/plugin/framework/handling-data/schemas#validators) in
 the Framework documentation for details. Refer to the
 [Attributes - Custom Validators](/plugin/framework/migrating/attributes-blocks/validators-custom) page in this guide to learn how to
 implement custom validators.
@@ -85,42 +85,40 @@ your requirements.
 
 ## Example
 
-The following examples show how to migrate portions of the [tls](https://github.com/hashicorp/terraform-provider-tls)
-provider.
-
-For a complete example, clone the
-`terraform-provider-tls` repository and compare the `provider.go` file in
-[v3.4.0](https://github.com/hashicorp/terraform-provider-tls/blob/v3.4.0/internal/provider/provider.go)
-with [v4.0.1](https://github.com/hashicorp/terraform-provider-tls/blob/v4.0.1/internal/provider/provider.go).
-
 ### SDKv2
 
-The following example from the `provider.go` file shows the implementation of the `ConflictsWith` field on the
-provider's `proxy` block's `url` attribute. This validator checks that the provider does not use the `url` attribute
-when the proxy's url is set through the environment. The example also uses the `RequiredWith` field to ensure that the
-`password` attribute is configured when `username` is, and vice-versa.
+The following example shows the implementation of the `ConflictsWith` field on the
+provider's `example_block` block's `example_attribute_one` attribute.
+This validator checks that the provider does not use the `example_attribute_one` attribute
+when the `example_attribute_four` is being used. The example also uses the `RequiredWith` field to ensure that the
+`example_attribute_two` attribute is configured when `example_attribute_one` is, and that the
+`example_attribute_three` attribute is configured when `example_attribute_two` is.
 
 ```go
 func New() (*schema.Provider, error) {
     return &schema.Provider{
         Schema: map[string]*schema.Schema{
-            "proxy": {
+            "example_block": {
                 Elem: &schema.Resource{
                     Schema: map[string]*schema.Schema{
-                        "url": {
-                            ConflictsWith: []string{"proxy.0.from_env"},
+                        "example_attribute_one": {
+                            ConflictsWith: []string{"example_block.0.example_attribute_four"},
                             /* ... */
                         },
-                        "username": {
-                            RequiredWith: []string{"proxy.0.url"},
+                        "example_attribute_two": {
+                            RequiredWith: []string{"example_block.0.example_attribute_one"},
                             /* ... */
                         },
-                        "password": {
-                            RequiredWith: []string{"proxy.0.username"},
+                        "example_attribute_three": {
+                            RequiredWith: []string{"example_block.0.example_attribute_two"},
                             /* ... */
                         },
-                        "from_env": {
-                            ConflictsWith: []string{"proxy.0.url", "proxy.0.username", "proxy.0.password"},
+                        "example_attribute_four": {
+                            ConflictsWith: []string{
+                                "example_block.0.example_attribute_one",
+                                "example_block.0.example_attribute_two",
+                                "example_block.0.example_attribute_three",
+                            },
                             /* ... */
                         },
                     },
@@ -136,39 +134,39 @@ func New() (*schema.Provider, error) {
 The following shows the same section of provider code after the migration.
 
 This code implements the `ConflictsWith` and `AlsoRequires` validators with the Framework. The validators are configured
-via the `Validators` field of the provider's `proxy` block's attribute schema.
+via the `Validators` field of the provider's `example_block` block's attribute schema.
 
 ```go
 func (p *TlsProvider) Schema(_ context.Context, _ provider.SchemaRequest, resp *provider.SchemaResponse) {
     resp.Schema = schema.Schema{
         Blocks: map[string]schema.Block{
-            "proxy": schema.ListNestedBlock{
+            "example_block": schema.ListNestedBlock{
                 NestedObject: schema.NestedBlockObject{
                     Attributes: map[string]schema.Attribute{
-                        "url": schema.StringAttribute{
+                        "example_attribute_one": schema.StringAttribute{
                             Validators: []validator.String{
-                                stringvalidator.ConflictsWith(path.MatchRelative().AtParent().AtName("from_env")),
+                                stringvalidator.ConflictsWith(path.MatchRelative().AtParent().AtName("example_attribute_four")),
                             },
                             /* ... */
                         },
-                        "username": schema.StringAttribute{
+                        "example_attribute_two": schema.StringAttribute{
                             Validators: []validator.String{
-                                stringvalidator.AlsoRequires(path.MatchRelative().AtParent().AtName("url")),
+                                stringvalidator.AlsoRequires(path.MatchRelative().AtParent().AtName("example_attribute_one")),
                             },
                             /* ... */
                         },
-                        "password": schema.StringAttribute{
+                        "example_attribute_three": schema.StringAttribute{
                             Validators: []validator.String{
-                                stringvalidator.AlsoRequires(path.MatchRelative().AtParent().AtName("username")),
+                                stringvalidator.AlsoRequires(path.MatchRelative().AtParent().AtName("example_attribute_two")),
                             },
                             /* ... */
                         },
-                        "from_env": schema.BoolAttribute{
+                        "example_attribute_four": schema.BoolAttribute{
                             Validators: []validator.Bool{
                                 boolvalidator.ConflictsWith(
-                                    path.MatchRelative().AtParent().AtName("url"),
-                                    path.MatchRelative().AtParent().AtName("username"),
-                                    path.MatchRelative().AtParent().AtName("password"),
+                                    path.MatchRelative().AtParent().AtName("example_attribute_one"),
+                                    path.MatchRelative().AtParent().AtName("example_attribute_two"),
+                                    path.MatchRelative().AtParent().AtName("example_attribute_three"),
                                 ),
                             },
                             /* ... */