Improve documentation

Author: linus-mullvad

src/policy/builtin.rs

@@ -1,3 +1,9 @@
+//! Built-in policies for Sigsum.
+//!
+//! This module contains all the included built-in policies. These can be accessed
+//! and used directly as public statics, or looked up at runtime by name via
+//! [`Policy::builtin`].
+
 use std::ops::Deref;
 use std::sync::LazyLock;
 

src/policy/mod.rs

@@ -60,6 +60,8 @@ impl<'a> Iterator for Logs<'a> {
 
 impl Policy {
     /// Returns a built-in policy by name, if one exists.
+    ///
+    /// See [`builtin`] for public static definitions of these policies.
     pub fn builtin(name: &str) -> Option<&'static Self> {
         builtin::builtin(name)
     }