flat_jagged_vector comments refinment

Author: SpectraL519

Makefile

@@ -4,10 +4,10 @@ TAGS ?= dev
 .PHONY: docs serve-docs clean-docs clean doxy clean-doxy
 
 # Example usage: `make docs TAGS="v2.0.0 latest --update-aliases"`
-# uv run python scripts/gen_concept_docs.py --config docs/concepts_cfg.json --xml documentation/xml --out docs/cpp-gl
 docs:
 	@echo "==> Deploying MkDocs documentation locally via mike (Tags: $(TAGS))..."
 	doxygen Doxyfile
+	uv run python scripts/gen_concept_docs.py --config docs/concepts_cfg.json --xml documentation/xml --out docs/cpp-gl
 	uv run mike deploy $(TAGS)
 	@echo "==> Documentation deployed to local gh-pages branch."
 

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/graph.hpp

@@ -77,7 +77,7 @@ struct to_impl;
 ///
 /// ### Mathematics
 /// Inline math: \f$V = E - F + 2\f$
-/// Big-O: \f$\mathcal{O}(|V| + |E|)\f$
+/// Big-O: \f$O(|V| + |E|)\f$
 ///
 /// Display math:
 ///