Update some doc strings

Author: w1th0utnam3

splashsurf_lib/src/aabb.rs

@@ -158,7 +158,7 @@ where
         self.translate(&(self.centroid() * R::one().neg()));
     }
 
-    /// Applies a uniform, local scaling to the AABB (as if it was centered at the origin)
+    /// Multiplies a uniform, local scaling to the AABB (i.e. multiplying its extents as if it was centered at the origin)
     pub fn scale_uniformly(&mut self, scaling: R) {
         let center = self.centroid();
         self.translate(&(&center * R::one().neg()));
@@ -183,7 +183,7 @@ where
         }
     }
 
-    /// Grows this AABB uniformly in all directions by the given scalar margin
+    /// Grows this AABB uniformly in all directions by the given scalar margin (i.e. adding the margin to min/max extents)
     pub fn grow_uniformly(&mut self, margin: R) {
         self.min = &self.min - &VectorN::repeat(margin);
         self.max = &self.max + &VectorN::repeat(margin);

splashsurf_lib/src/lib.rs

@@ -122,7 +122,7 @@ macro_rules! map_option {
 }
 
 impl<R: Real> Parameters<R> {
-    /// Tries to convert the parameters from one real type to another real type, returns None if conversion fails
+    /// Tries to convert the parameters from one [Real] type to another [Real] type, returns None if conversion fails
     pub fn try_convert<T: Real>(&self) -> Option<Parameters<T>> {
         Some(Parameters {
             particle_radius: self.particle_radius.try_convert()?,