flat_matrix comments refinement

Author: SpectraL519

include/gl/edge_descriptor.hpp

@@ -202,28 +202,23 @@ class edge_descriptor final {
         return std::make_pair(this->_vertices.second, this->_vertices.first);
     }
 
-    // clang-format off
-    // gl_attr_force_inline misplacement
-
     /// @brief Returns the source vertex ID.
     /// @return The underlying integer ID of the source vertex.
-    [[nodiscard]] gl_attr_force_inline const id_type source() const noexcept {
+    [[nodiscard]] gl_attr_force_inline id_type source() const noexcept {
         return this->_vertices.first;
     }
 
     /// @brief Returns the target vertex ID.
     /// @return The underlying integer ID of the target vertex.
-    [[nodiscard]] gl_attr_force_inline const id_type target() const noexcept {
+    [[nodiscard]] gl_attr_force_inline id_type target() const noexcept {
         return this->_vertices.second;
     }
 
-    // clang-format on
-
     /// @brief Gets the other endpoint of the edge given one of its incident vertices.
     /// @param vertex_id The ID of one incident vertex.
     /// @return The ID of the opposite vertex.
     /// @throws std::invalid_argument If the provided `vertex_id` is not incident to this edge.
-    [[nodiscard]] const id_type other(const id_type vertex_id) const {
+    [[nodiscard]] id_type other(const id_type vertex_id) const {
         if (vertex_id == this->_vertices.first)
             return this->_vertices.second;
 

include/gl/types/flat_jagged_vector.hpp

@@ -2,6 +2,9 @@
 // This file is part of the CPP-GL project (https://github.com/SpectraL519/cpp-gl).
 // Licensed under the MIT License. See the LICENSE file in the project root for full license information.
 
+/// @file gl/types/flat_jagged_vector.hpp
+/// @brief Contains the implementation of a generic @ref gl::flat_jagged_vector "flat_jagged_vector" data structure.
+
 #pragma once
 
 #include "gl/types/core.hpp"
@@ -28,7 +31,7 @@ namespace gl {
 /// >
 /// > Behavior is similar to `std::vector<std::vector<T>>` but with flattened memory layout.
 ///
-/// > [!CAUTION] Iterator invalidation policy
+/// > [!IMPORTANT] Iterator invalidation policy
 /// >
 /// > Iterator invalidation follows `std::vector` semantics: modifying the structure or elements
 /// > invalidates all iterators, pointers, and references to the container's elements.