add doc support to nested field types

Adds documentation to the nested field types in `apis/$VERSION/types.go`
output for the structs and the fields within those structs. The fields
within the structs are modeled with the `pkg/model.Attr` struct, so I
added a `Shape` field to that in order to bring in the aws-sdk-go
`private/model/api.Shape` that has a `Documentation` field on it...

Related: aws-controllers-k8s/community#723

Author: jaypipes

pkg/generate/generator.go

@@ -356,6 +356,7 @@ func (g *Generator) GetTypeDefs() ([]*ackmodel.TypeDef, error) {
 			continue
 		}
 		tdefs = append(tdefs, &ackmodel.TypeDef{
+			Shape: shape,
 			Names: tdefNames,
 			Attrs: attrs,
 		})

pkg/model/type_def.go

@@ -14,6 +14,8 @@
 package model
 
 import (
+	awssdkmodel "github.com/aws/aws-sdk-go/private/model/api"
+
 	"github.com/aws-controllers-k8s/code-generator/pkg/names"
 )
 
@@ -29,4 +31,5 @@ const (
 type TypeDef struct {
 	Names names.Names
 	Attrs map[string]*Attr
+	Shape *awssdkmodel.Shape
 }

templates/apis/type_def.go.tpl

@@ -1,6 +1,12 @@
 {{- define "type_def" -}}
+{{- if .Shape.Documentation }}
+{{ .Shape.Documentation }}
+{{- end }}
 type {{ .Names.Camel }} struct {
 {{- range $attrName, $attr := .Attrs }}
+	{{- if $attr.Shape.Documentation }}
+	{{ $attr.Shape.Documentation }}
+	{{- end }}
 	{{ $attr.Names.Camel }} {{ $attr.GoType }} `json:"{{ $attr.Names.CamelLower }},omitempty"`
 {{- end }}
 }