Describe configuration flow in comments

Signed-off-by: Atanas Dinov <[email protected]>

pkg/combustion/combustion.go

@@ -9,8 +9,16 @@ import (
 	"github.com/suse-edge/edge-image-builder/pkg/fileio"
 )
 
+// configureComponent defines the combustion component contract.
+// Each component (e.g. "users") receives the necessary dir structure and
+// additional values it should be operating with through a Context object.
+//
+// configureComponent returns a slice of scripts which should be executed as part of the Combustion script.
+// Result can also be an empty slice or nil if this is not necessary.
 type configureComponent func(context *context.Context) ([]string, error)
 
+// Configure iterates over all separate Combustion components and configures them independently.
+// If all of those are successful, the Combustion script is assembled and written to the file system.
 func Configure(ctx *context.Context) error {
 	var combustionScripts []string