docs: clarify LUFS terminology and fix normalise parameter comments

flexiondotorg · flexiondotorg · commit c2bfb7ce5367 · 2026-03-14T21:08:58.000+01:00
- Correct README "podcast/broadcast standard" to "common podcast target"
  (broadcast standards are -23/-24 LUFS, not -16)
- Fix normalise.go comments: reference intermediate -processed path,
  not post-rename filename (LUFS rename happens in ProcessAudio)

Signed-off-by: Martin Wimpress &lt;code@wimpress.io&gt;
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@ Raw microphone recordings into broadcast-ready audio in one command. No configur
 jivetalking presenter1.flac presenter2.flac
 ```
 
-Your files emerge at -16 LUFS, the podcast/broadcast standard, with room rumble, background hiss, clicks, and harsh sibilance sorted automatically. Everything needed is embedded in the binary. This is not how audio tools usually work, and that is rather the point.
+Your files emerge at -16 LUFS, a common podcast target, with room rumble, background hiss, clicks, and harsh sibilance sorted automatically. Everything needed is embedded in the binary. This is not how audio tools usually work, and that is rather the point.
 
 ---
 
diff --git a/internal/processor/normalise.go b/internal/processor/normalise.go
@@ -113,7 +113,7 @@ type LoudnormMeasurement struct {
 // Instead, we read the Pass 2 output file here without writing, just to get measurements.
 //
 // Parameters:
-//   - inputPath: Path to Pass 2 output file (the -LUFS-NN-processed file)
+//   - inputPath: Path to Pass 2 output file (the -processed file, before LUFS rename)
 //   - config: Filter configuration (contains loudnorm targets)
 //   - progressCallback: Optional progress updates (pass 3)
 //
@@ -363,7 +363,7 @@ type NormalisationResult struct {
 // - Preserves natural dynamics while hitting target loudness
 //
 // Parameters:
-//   - inputPath: Path to Pass 2 output file (the -LUFS-NN-processed file)
+//   - inputPath: Path to Pass 2 output file (the -processed file, before LUFS rename)
 //   - config: Filter configuration (contains loudnorm targets)
 //   - outputMeasurements: Pass 2 measurements (for reference, not used for loudnorm)
 //   - inputMeasurements: Pass 1 measurements (contains NoiseProfile and SpeechProfile for region capture)
