Improve logging, cleanup variables and comments

zebra-network/src/peer_set/initialize.rs

@@ -160,16 +160,19 @@ where
         .await
         .expect("unexpected panic in spawned initial peers task")
         .expect("unexpected error connecting to initial peers");
-    let initial_peer_count = active_outbound_connections.update_count();
+    let active_initial_peer_count = active_outbound_connections.update_count();
 
     // We need to await candidates.update() here, because zcashd only sends one
     // `addr` message per connection, and if we only have one initial peer we
     // need to ensure that its `addr` message is used by the crawler.
 
-    info!("Sending initial request for peers");
-    let _ = candidates.update_initial(initial_peer_count).await;
+    info!(
+        ?active_initial_peer_count,
+        "sending initial request for peers"
+    );
+    let _ = candidates.update_initial(active_initial_peer_count).await;
 
-    // TODO: reduce demand by initial_peer_count (#2902)
+    // TODO: reduce demand by `active_outbound_connections.update_count()` (#2902)
     for _ in 0..config.peerset_initial_target_size {
         let _ = demand_tx.try_send(MorePeers);
     }
@@ -582,6 +585,7 @@ where
 }
 
 /// Try to connect to `candidate` using `outbound_connector`.
+/// Uses `outbound_connection_tracker` to track the active connection count.
 ///
 /// Returns a `HandshakeConnected` action on success, and a
 /// `HandshakeFailed` action on error.

zebra-network/src/peer_set/limit.rs

@@ -15,10 +15,10 @@ pub struct ConnectionClosed;
 
 /// A counter for active connections.
 ///
-/// Creates [`ConnectionTracker`] to track each active connection.
+/// Creates a [`ConnectionTracker`] to track each active connection.
 /// When these trackers are dropped, the counter gets notified.
 pub struct ActiveConnectionCounter {
-    /// The current number of peers connected to Zebra.
+    /// The number of peers active peers tracked using this counter.
     count: usize,
 
     /// The channel used to send closed connection notifications.