Use proper doc comments for get_bootstrap and get_bootstrap_by_crate

Author: tgnottingham

database/src/pool.rs

@@ -67,21 +67,21 @@ pub trait Connection: Send + Sync {
         krate: &str,
         value: Duration,
     );
-    // Returns vector of bootstrap build times for the given artifacts. The kth
-    // element is the minimum build time for the kth artifact in `aids`, across
-    // all collections for the artifact, or none if there is no bootstrap data
-    // for that artifact (for example, because the rustc benchmark wasn't
-    // executed for that artifact).
+    /// Returns vector of bootstrap build times for the given artifacts. The kth
+    /// element is the minimum build time for the kth artifact in `aids`, across
+    /// all collections for the artifact, or none if there is no bootstrap data
+    /// for that artifact (for example, because the rustc benchmark wasn't
+    /// executed for that artifact).
     async fn get_bootstrap(&self, aids: &[ArtifactIdNumber]) -> Vec<Option<Duration>>;
-    // Returns map from rustc crate name to vector of build times for that crate
-    // for the given artifacts. Within a crate's corresponding vector, the kth
-    // element is the minimum build time for the kth artifact in `aids`, across
-    // all collections for the artifact, or none if there is no data for that
-    // artifact / crate combination (for example, because that rustc crate
-    // wasn't present when building rustc with that artifact, or because the
-    // rustc benchmark wasn't executed for that artifact). A crate will not be
-    // included as a key in the map unless at least one artifact in `aids` has a
-    // build time for it.
+    /// Returns map from rustc crate name to vector of build times for that crate
+    /// for the given artifacts. Within a crate's corresponding vector, the kth
+    /// element is the minimum build time for the kth artifact in `aids`, across
+    /// all collections for the artifact, or none if there is no data for that
+    /// artifact / crate combination (for example, because that rustc crate
+    /// wasn't present when building rustc with that artifact, or because the
+    /// rustc benchmark wasn't executed for that artifact). A crate will not be
+    /// included as a key in the map unless at least one artifact in `aids` has a
+    /// build time for it.
     async fn get_bootstrap_by_crate(
         &self,
         aids: &[ArtifactIdNumber],