library: document serialize module

src/serialize/coefficient.rs

@@ -1,3 +1,6 @@
+//! Helper functions deserialize coefficients.
+
+/// Returns the identity for a f32, i.e. 1.0.
 pub fn default_identity() -> f32 {
     1.
 }

src/serialize/mod.rs

@@ -1,3 +1,5 @@
+//! Helper functions to help scene (de)serialization
+
 pub mod vector;
 pub use vector::*;
 

src/serialize/vector.rs

@@ -1,6 +1,11 @@
+//! Helper functions to deserialize `Vector` values.
+
 use crate::Vector;
 use serde::de::{Deserialize, Deserializer};
 
+/// Deserialize a vector.
+///
+/// Needs a custom implementation to make sur the vector is normalized when deserialized.
 pub fn vector_normalizer<'de, D>(deserializer: D) -> Result<Vector, D::Error>
 where
     D: Deserializer<'de>,