Add comments to public structs

Signed-off-by: Alex Ellis (OpenFaaS Ltd) <alexellis2@gmail.com>

schema/image.go

@@ -46,16 +46,16 @@ func (i *BuildFormat) String() string {
 }
 
 // Set implements pflag.Value
-func (l *BuildFormat) Set(value string) error {
+func (i *BuildFormat) Set(value string) error {
 	switch strings.ToLower(value) {
 	case "", "default", "latest":
-		*l = DefaultFormat
+		*i = DefaultFormat
 	case "sha":
-		*l = SHAFormat
+		*i = SHAFormat
 	case "branch":
-		*l = BranchAndSHAFormat
+		*i = BranchAndSHAFormat
 	case "describe":
-		*l = DescribeFormat
+		*i = DescribeFormat
 	default:
 		return fmt.Errorf("unknown image tag format: '%s'", value)
 	}

schema/metadata.go

@@ -3,7 +3,7 @@
 
 package schema
 
-//Metadata metadata of the object
+// Metadata metadata of the object
 type Metadata struct {
 	Name      string `yaml:"name"`
 	Namespace string `yaml:"namespace,omitempty"`

stack/schema.go

@@ -13,7 +13,8 @@ type Provider struct {
 // Function as deployed or built on FaaS
 type Function struct {
 	// Name of deployed function
-	Name     string `yaml:"-"`
+	Name string `yaml:"-"`
+
 	Language string `yaml:"lang"`
 
 	// Handler Local folder to use for function
@@ -61,14 +62,17 @@ type Function struct {
 	Namespace string `yaml:"namespace,omitempty"`
 }
 
+// Configuration for the stack.yml file
 type Configuration struct {
 	StackConfig StackConfiguration `yaml:"configuration"`
 }
 
+// StackConfiguration for the overall stack.yml
 type StackConfiguration struct {
 	TemplateConfigs []TemplateSource `yaml:"templates"`
 }
 
+// TemplateSource for build templates
 type TemplateSource struct {
 	Name   string `yaml:"name"`
 	Source string `yaml:"source,omitempty"`
@@ -102,6 +106,7 @@ type LanguageTemplate struct {
 	WelcomeMessage string `yaml:"welcome_message"`
 }
 
+// BuildOption a named build option for one or more packages
 type BuildOption struct {
 	Name     string   `yaml:"name"`
 	Packages []string `yaml:"packages"`