diff --git a/include/dpp/isa/avx.h b/include/dpp/isa/avx.h
index 1700ca7808..3dc2914d0f 100644
--- a/include/dpp/isa/avx.h
+++ b/include/dpp/isa/avx.h
@@ -73,7 +73,10 @@ namespace dpp {
 		}
 
 	protected:
-		alignas(16) float values[byte_blocks_per_register]{};///< Array for storing the values to be loaded/stored.
+		/**
+		 * @brief Array for storing the values to be loaded/stored.
+		 */
+		alignas(16) float values[byte_blocks_per_register]{};
 
 		/**
 		 * @brief Stores values from a 128-bit AVX vector to a storage location.
diff --git a/include/dpp/isa/avx2.h b/include/dpp/isa/avx2.h
index 579025f246..1e02eaa935 100644
--- a/include/dpp/isa/avx2.h
+++ b/include/dpp/isa/avx2.h
@@ -76,7 +76,10 @@ namespace dpp {
 		}
 
 	protected:
-		alignas(32) float values[byte_blocks_per_register]{};///< Array for storing the values to be loaded/stored.
+		/**
+		 * @brief Array for storing the values to be loaded/stored.
+		 */
+		alignas(32) float values[byte_blocks_per_register]{};
 
 		/**
 		 * @brief Stores values from a 256-bit AVX2 vector to a storage location.
diff --git a/include/dpp/isa/avx512.h b/include/dpp/isa/avx512.h
index 2bdc3344e6..bdf1d47859 100644
--- a/include/dpp/isa/avx512.h
+++ b/include/dpp/isa/avx512.h
@@ -79,7 +79,10 @@ namespace dpp {
 		}
 
 	protected:
-		alignas(64) float values[byte_blocks_per_register]{};///< Array for storing the values to be loaded/stored.
+		/**
+		 * @brief Array for storing the values to be loaded/stored.
+		 */
+		alignas(64) float values[byte_blocks_per_register]{};
 
 		/**
 		 * @brief Stores values from a 512-bit AVX512 vector to a storage location.
diff --git a/src/dpp/utility.cpp b/src/dpp/utility.cpp
index 947f665962..07638d1201 100644
--- a/src/dpp/utility.cpp
+++ b/src/dpp/utility.cpp
@@ -877,15 +877,23 @@ std::string make_url_parameters(const std::map<std::string, uint64_t>& parameter
 
 std::string markdown_escape(const std::string& text, bool escape_code_blocks) {
 	/**
-		* @brief Represents the current state of the finite state machine
-		* for the markdown_escape function.
-		*/
+	 * @brief Represents the current state of the finite state machine
+	 * for the markdown_escape function.
+	 */
 	enum md_state {
-		/// normal text
+		/**
+		 * @brief Normal text
+		 */
 		md_normal = 0,
-		/// a paragraph code block, represented by three backticks
+
+		/**
+		 * @brief A paragraph code block, represented by three backticks.
+		 */
 		md_big_code_block = 1,
-		/// an inline code block, represented by one backtick
+
+		/**
+		 * @brief An inline code block, represented by one backtick.
+		 */
 		md_small_code_block = 2,
 	};