Remove comments from new code

Author: MimoJanra

composition.go

@@ -10,7 +10,6 @@ import (
 	"gopkg.in/yaml.v3"
 )
 
-// FromYAMLFiles merges multiple YAML files. Later files override earlier ones.
 func FromYAMLFiles(paths ...string) Source {
 	merged, err := mergeFiles(paths, func(data []byte) (map[string]any, error) {
 		var m map[string]any
@@ -22,7 +21,6 @@ func FromYAMLFiles(paths ...string) Source {
 	return &multiFileSource{name: "yaml", data: merged}
 }
 
-// FromJSONFiles merges multiple JSON files. Later files override earlier ones.
 func FromJSONFiles(paths ...string) Source {
 	merged, err := mergeFiles(paths, func(data []byte) (map[string]any, error) {
 		var m map[string]any
@@ -34,7 +32,6 @@ func FromJSONFiles(paths ...string) Source {
 	return &multiFileSource{name: "json", data: merged}
 }
 
-// FromTOMLFiles merges multiple TOML files. Later files override earlier ones.
 func FromTOMLFiles(paths ...string) Source {
 	merged, err := mergeFiles(paths, func(data []byte) (map[string]any, error) {
 		var m map[string]any
@@ -62,7 +59,6 @@ func mergeFiles(paths []string, parse func([]byte) (map[string]any, error)) (map
 	return merged, nil
 }
 
-// deepMerge merges src into dst. Nested maps are merged recursively; scalars are overwritten.
 func deepMerge(dst, src map[string]any) {
 	for k, v := range src {
 		if srcMap, ok := v.(map[string]any); ok {

otel/tracer.go

@@ -1,13 +1,3 @@
-// Package otel provides OpenTelemetry tracing integration for confkit.
-//
-// Usage:
-//
-//	import "github.com/MimoJanra/confkit/otel"
-//
-//	cfg, err := otel.Load[Config](ctx, tracer,
-//	    confkit.FromEnv(),
-//	    confkit.FromYAML("config.yaml"),
-//	)
 package otel
 
 import (
@@ -19,7 +9,6 @@ import (
 	"go.opentelemetry.io/otel/trace"
 )
 
-// Load wraps confkit.Load with an OpenTelemetry span.
 func Load[T any](ctx context.Context, tracer trace.Tracer, sources ...confkit.Source) (T, error) {
 	ctx, span := tracer.Start(ctx, "confkit.Load")
 	defer span.End()
@@ -38,7 +27,6 @@ func Load[T any](ctx context.Context, tracer trace.Tracer, sources ...confkit.So
 	return cfg, nil
 }
 
-// LoadWithOptions wraps confkit.LoadWithOptions with an OpenTelemetry span.
 func LoadWithOptions[T any](ctx context.Context, tracer trace.Tracer, options ...confkit.Option) (T, error) {
 	ctx, span := tracer.Start(ctx, "confkit.Load")
 	defer span.End()

prometheus/metrics.go

@@ -1,14 +1,3 @@
-// Package prometheus provides Prometheus metrics integration for confkit.
-//
-// Usage:
-//
-//	import "github.com/MimoJanra/confkit/prometheus"
-//
-//	m := prometheus.NewMetrics(prometheus.DefaultRegisterer)
-//	cfg, err := confkit.LoadWithOptions[Config](
-//	    confkit.WithSource(confkit.FromEnv()),
-//	    m.Hook(),
-//	)
 package prometheus
 
 import (
@@ -18,14 +7,12 @@ import (
 	"github.com/prometheus/client_golang/prometheus"
 )
 
-// Metrics holds Prometheus instruments for confkit load operations.
 type Metrics struct {
 	loadsTotal   *prometheus.CounterVec
 	loadDuration prometheus.Histogram
 	errorsTotal  *prometheus.CounterVec
 }
 
-// NewMetrics creates and registers Prometheus metrics.
 func NewMetrics(reg prometheus.Registerer) *Metrics {
 	m := &Metrics{
 		loadsTotal: prometheus.NewCounterVec(prometheus.CounterOpts{
@@ -46,10 +33,8 @@ func NewMetrics(reg prometheus.Registerer) *Metrics {
 	return m
 }
 
-// DefaultRegisterer is prometheus.DefaultRegisterer.
 var DefaultRegisterer = prometheus.DefaultRegisterer
 
-// Hook returns a confkit.Option that records metrics for every Load call.
 func (m *Metrics) Hook() confkit.Option {
 	return confkit.WithLoadHook(func(success bool, d time.Duration, errCount int) {
 		if success {

validators_builtin.go

@@ -17,8 +17,6 @@ var (
 	hostnameRegex = regexp.MustCompile(`^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$`)
 )
 
-// validateBuiltin handles built-in format validators.
-// Returns (FieldError, true) if the rule was recognized, (FieldError{}, false) if not.
 func (v *Validator) validateBuiltin(fieldVal reflect.Value, field FieldInfo, rule ValidationRule) (FieldError, bool) {
 	switch rule.Name {
 	case "email":