conversion docs

Author: SpectraL519

include/gl/conversion.hpp

@@ -16,10 +16,16 @@ namespace gl {
 
 namespace traits {
 
+/// @ingroup GL GL-Traits
+/// @brief Utility trait type used to swap the implementation tag of a graph traits or graph type.
+/// ### See Also:
+/// - @ref gl::to "to" : For the function that utilizes this trait to perform graph conversions between different implementations.
 template <typename GT, traits::c_graph_impl_tag NewImplTag>
 requires c_graph<GT> or c_instantiation_of<GT, graph_traits>
 struct swap_impl_tag;
 
+/// @ingroup GL GL-Traits
+/// @brief Specialization of @ref gl::traits::swap_impl_tag "swap_impl_tag" for the @ref gl::graph_traits "graph_traits" type.
 template <
     traits::c_graph_directional_tag Dir,
     traits::c_properties VP,
@@ -31,6 +37,8 @@ struct swap_impl_tag<graph_traits<Dir, VP, EP, OldImplTag, IdType>, NewImplTag>
     using type = graph_traits<Dir, VP, EP, NewImplTag, IdType>;
 };
 
+/// @ingroup GL GL-Traits
+/// @brief Specialization of @ref gl::traits::swap_impl_tag "swap_impl_tag" for the @ref gl::graph "graph" class.
 template <
     traits::c_graph_directional_tag Dir,
     traits::c_properties VP,
@@ -42,6 +50,10 @@ struct swap_impl_tag<graph<graph_traits<Dir, VP, EP, OldImplTag, IdType>>, NewIm
     using type = graph<graph_traits<Dir, VP, EP, NewImplTag, IdType>>;
 };
 
+/// @ingroup GL GL-Traits
+/// @brief Alias template for easier usage of the `swap_impl_tag` trait to resolve the swapped type directly.
+/// ### See Also:
+/// - @ref gl::to "to" : For the function that utilizes this trait to perform graph conversions between different implementations.
 template <typename GT, traits::c_graph_impl_tag NewImplTag>
 requires c_graph<GT> or c_instantiation_of<GT, graph_traits>
 using swap_impl_tag_t = typename swap_impl_tag<GT, NewImplTag>::type;
@@ -154,6 +166,8 @@ struct to_impl<impl::matrix_t, impl::flat_matrix_t> {
 /// | Graph         | The type of the source graph, which will be automatically deduced from the function argument. | [**c_graph**](gl_concepts.md#gl-traits-c-graph) |
 /// @param source The graph to convert. After the operation it will be left in a valid, empty state.
 /// @return A new graph containing the moved data, structured according to TargetImplTag.
+/// ### See Also
+/// - @ref gl::traits::swap_impl_tag "swap_impl_tag" : For the trait used to resolve the target graph type with the swapped implementation tag.
 template <traits::c_graph_impl_tag TargetImplTag, traits::c_graph Graph>
 [[nodiscard]] auto to(Graph&& source) {
     using source_traits = typename Graph::traits_type;