Improve struct and field comments and incorporate into json schema (#4252)

* improve struct and field comments and incorporate into json schema

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

* address review feedback

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

---------

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

syft/pkg/rockspec.go

@@ -1,11 +1,25 @@
 package pkg
 
+// LuaRocksPackage represents a Lua package managed by the LuaRocks package manager with metadata from .rockspec files.
 type LuaRocksPackage struct {
-	Name         string            `json:"name"`
-	Version      string            `json:"version"`
-	License      string            `json:"license"`
-	Homepage     string            `json:"homepage"`
-	Description  string            `json:"description"`
-	URL          string            `json:"url"`
+	// Name is the package name as found in the .rockspec file
+	Name string `json:"name"`
+
+	// Version is the package version as found in the .rockspec file
+	Version string `json:"version"`
+
+	// License is license identifier
+	License string `json:"license"`
+
+	// Homepage is project homepage URL
+	Homepage string `json:"homepage"`
+
+	// Description is a human-readable package description
+	Description string `json:"description"`
+
+	// URL is the source download URL
+	URL string `json:"url"`
+
+	// Dependencies are the map of dependency names to version constraints
 	Dependencies map[string]string `json:"dependencies"`
 }