docs(src): add examples alias and general cleanup (#2763)

src/audio.h

@@ -1,6 +1,6 @@
 /**
  * @file src/audio.h
- * @brief todo
+ * @brief Declarations for audio capture and encoding.
  */
 #pragma once
 
@@ -8,13 +8,13 @@
 #include "utility.h"
 namespace audio {
   enum stream_config_e : int {
-    STEREO,
-    HIGH_STEREO,
-    SURROUND51,
-    HIGH_SURROUND51,
-    SURROUND71,
-    HIGH_SURROUND71,
-    MAX_STREAM_CONFIG
+    STEREO,  ///< Stereo
+    HIGH_STEREO,  ///< High stereo
+    SURROUND51,  ///< Surround 5.1
+    HIGH_SURROUND51,  ///< High surround 5.1
+    SURROUND71,  ///< Surround 7.1
+    HIGH_SURROUND71,  ///< High surround 7.1
+    MAX_STREAM_CONFIG  ///< Maximum audio stream configuration
   };
 
   struct opus_stream_config_t {
@@ -37,10 +37,10 @@ namespace audio {
 
   struct config_t {
     enum flags_e : int {
-      HIGH_QUALITY,
-      HOST_AUDIO,
-      CUSTOM_SURROUND_PARAMS,
-      MAX_FLAGS
+      HIGH_QUALITY,  ///< High quality audio
+      HOST_AUDIO,  ///< Host audio
+      CUSTOM_SURROUND_PARAMS,  ///< Custom surround parameters
+      MAX_FLAGS  ///< Maximum number of flags
     };
 
     int packetDuration;