strip redundant doc comments from signed_core and signed_git

crates/signed_git/src/cache.rs

@@ -5,7 +5,6 @@ use signed_core::{Announcement, RepoAddr};
 
 use crate::repo::Repo;
 
-/// On-disk cache of cloned repositories, keyed by owner pubkey / repo id.
 #[derive(Debug, Clone)]
 pub struct GitCache {
     root: PathBuf,
@@ -36,7 +35,6 @@ impl GitCache {
         }
     }
 
-    /// Open the existing clone, fetching it first.
     pub fn ensure_clone<U: AsRef<str>>(&self, addr: &RepoAddr, clone_urls: &[U]) -> Result<Repo> {
         let path = self.repo_path(addr);
 
@@ -53,7 +51,8 @@ impl GitCache {
         Repo::clone(clone_urls, &path)
     }
 
-    /// Map an untrusted repository id or display name to a safe single path component.
+    // `id` is untrusted relay content: it must never escape the cache root as
+    // a single path component.
     pub fn sanitize_path_component(id: &str) -> String {
         let sanitized: String = id
             .chars()
@@ -73,7 +72,6 @@ impl GitCache {
         sanitized
     }
 
-    /// The refs namespace of a fork's import in the target mirror.
     pub fn fork_namespace(announcement: &Announcement) -> String {
         format!(
             "{}/{}",