fix docs

Core/include/Acts/Material/HomogeneousSurfaceMaterial.hpp

@@ -90,10 +90,14 @@ class HomogeneousSurfaceMaterial : public ISurfaceMaterial {
   /// The five different MaterialSlab
   MaterialSlab m_fullMaterial;
 
-  /// Check if two materials are exactly equal.
-  /// @note This is a strict equality check, i.e. the materials must
-  /// have identical properties.
-  /// @param other is the material to compare to
+  /// @brief Check if two materials are exactly equal.
+  ///
+  /// This is a strict equality check, i.e. the materials must have identical
+  /// properties.
+  ///
+  /// @param lhs is the left hand side material
+  /// @param rhs is the right hand side material
+  ///
   /// @return true if the materials are equal
   friend constexpr bool operator==(const HomogeneousSurfaceMaterial& lhs,
                                    const HomogeneousSurfaceMaterial& rhs) {

Core/include/Acts/Material/HomogeneousVolumeMaterial.hpp

@@ -61,10 +61,14 @@ class HomogeneousVolumeMaterial : public IVolumeMaterial {
  private:
   Material m_material;
 
-  /// Check if two materials are exactly equal.
-  /// @note This is a strict equality check, i.e. the materials must
-  /// have identical properties.
-  /// @param other is the material to compare to
+  /// @brief Check if two materials are exactly equal.
+  ///
+  /// This is a strict equality check, i.e. the materials must have identical
+  /// properties.
+  ///
+  /// @param lhs is the left hand side material
+  /// @param rhs is the right hand side material
+  ///
   /// @return true if the materials are equal
   friend constexpr bool operator==(const HomogeneousVolumeMaterial& lhs,
                                    const HomogeneousVolumeMaterial& rhs) {

Core/include/Acts/Material/Material.hpp

@@ -111,10 +111,14 @@ class Material {
   float m_z = 0.0f;
   float m_molarRho = 0.0f;
 
-  /// Check if two materials are exactly equal.
-  /// @note This is a strict equality check, i.e. the materials must
-  /// have identical properties.
-  /// @param mat is the material to compare to
+  /// @brief Check if two materials are exactly equal.
+  ///
+  /// This is a strict equality check, i.e. the materials must have identical
+  /// properties.
+  ///
+  /// @param lhs is the left hand side material
+  /// @param rhs is the right hand side material
+  ///
   /// @return true if the materials are equal
   friend constexpr bool operator==(const Material& lhs, const Material& rhs) {
     return (lhs.m_x0 == rhs.m_x0) && (lhs.m_l0 == rhs.m_l0) &&

Core/include/Acts/Material/MaterialSlab.hpp

@@ -79,10 +79,14 @@ class MaterialSlab {
   float m_thicknessInX0 = 0.0f;
   float m_thicknessInL0 = 0.0f;
 
-  /// Check if two materials are exactly equal.
-  /// @note This is a strict equality check, i.e. the materials must
-  /// have identical properties.
-  /// @param other is the material to compare to
+  /// @brief Check if two materials are exactly equal.
+  ///
+  /// This is a strict equality check, i.e. the materials must have identical
+  /// properties.
+  ///
+  /// @param lhs is the left hand side material
+  /// @param rhs is the right hand side material
+  ///
   /// @return true if the materials are equal
   friend constexpr bool operator==(const MaterialSlab& lhs,
                                    const MaterialSlab& rhs) {