Better commenting throughout

internal/status/status.go

@@ -5,7 +5,8 @@ import (
 	"image/color"
 )
 
-// HUD resource entry.
+// Meter types
+
 type Meter struct {
 	Label string
 	Base  float64
@@ -13,19 +14,18 @@ type Meter struct {
 	Color color.NRGBA
 }
 
-// Meter template values.
 type Config struct {
 	Label string
 	Base  float64
 	Color color.NRGBA
 }
 
-// Collection of meters.
+// Meter manager
+
 type Manager struct {
 	meters []Meter
 }
 
-// Builds meters from configs.
 func NewManager(cfgs []Config) *Manager {
 	meters := make([]Meter, len(cfgs))
 	for i, cfg := range cfgs {
@@ -40,20 +40,20 @@ func NewManager(cfgs []Config) *Manager {
 	return &Manager{meters: meters}
 }
 
-// Resets levels to base.
 func (m *Manager) Update() {
 	for i := range m.meters {
 		m.meters[i].Level = m.meters[i].Base
 	}
 }
 
-// Meters exposes a copy of the internal slice to prevent mutation.
 func (m *Manager) Meters() []Meter {
 	out := make([]Meter, len(m.meters))
 	copy(out, m.meters)
 	return out
 }
 
+// Helper functions
+
 func clamp(value, min, max float64) float64 {
 	if value < min {
 		return min