Merge: Revert "[Backport release-24.11] nixos/alsa: rebirth from the …

…ashes" (#373263)

nixos/doc/manual/release-notes/rl-2411.section.md

@@ -934,16 +934,15 @@ The `sound` options have been largely removed, as they are unnecessary for most
 
 If you set `sound.enable` in your configuration:
   - If you are using Pulseaudio or PipeWire, simply remove that option
-  - If you are using ALSA as your only sound system (no sound server), set `hardware.alsa.enable = true` instead
+  - If you are not using an external sound server, and want volumes to be persisted across shutdowns, set `hardware.alsa.enablePersistence = true` instead
 
 If you set `sound.enableOSSEmulation` in your configuration:
   - Make sure it is still necessary, as very few applications actually use OSS
-  - If necessary, set `hardware.alsa.enableOSSEmulation = true`
+  - If necessary, set `boot.kernelModules = [ "snd_pcm_oss" ]`
 
 If you set `sound.extraConfig` in your configuration:
-  - If you are using a sound server, like Pulseaudio, JACK or PipeWire, migrate your configuration to that
-  - If you are using ALSA as your only sound system, check if you can use the new structured ALSA options `hardware.alsa.defaultDevice`, `hardware.alsa.cardAliases`, `hardware.alsa.controls`, etc.
-  - Otherwise, move your configuration directly into `hardware.alsa.config`
+  - If you are using another sound server, like Pulseaudio, JACK or PipeWire, migrate your configuration to that
+  - If you are not using an external sound server, set `environment.etc."asound.conf".text = yourExtraConfig` instead
 
 If you set `sound.mediaKeys` in your configuration:
   - Preferably switch to handling media keys in your desktop environment/compositor