Use tools.go to ensure we keep necessary dependencies

Author: zph

main.go

@@ -4,8 +4,6 @@ package main
 import (
 	"github.com/hashicorp/terraform-plugin-sdk/v2/plugin"
 	"github.com/petoju/terraform-provider-mysql/v3/mysql"
-  // Added to ensure we have tfplugindocs available in go.mod
-  _ "github.com/hashicorp/terraform-plugin-docs"
 )
 
 func main() {

tools.go

@@ -0,0 +1,12 @@
+//go:build tools
+
+/*
+  Used for keeping ftplugindocs in the go.mod when using go mod tidy
+  and used as go:generate
+  Recommended approach per: https://github.com/golang/go/issues/25922#issuecomment-413898264
+*/
+package main
+
+import (
+    _ "github.com/hashicorp/terraform-plugin-docs/cmd/tfplugindocs"
+)