Add missing docs for connectors modules

apollo-router/src/services/connect.rs

@@ -1,4 +1,4 @@
-#![allow(missing_docs)] // FIXME
+//! Connect service request and response types.
 
 use std::sync::Arc;
 

apollo-router/src/services/connector_service.rs

@@ -1,4 +1,4 @@
-//! Tower fetcher for fetch node execution.
+//! Tower service for connectors.
 
 use std::collections::HashMap;
 use std::sync::Arc;
@@ -47,6 +47,7 @@ pub(crate) const APOLLO_CONNECTOR_SOURCE_NAME: Key =
 pub(crate) const APOLLO_CONNECTOR_SOURCE_DETAIL: Key =
     Key::from_static_str("apollo.connector.source.detail");
 
+/// A service for executing connector requests.
 #[derive(Clone)]
 pub(crate) struct ConnectorService {
     pub(crate) http_service_factory: Arc<IndexMap<String, HttpClientServiceFactory>>,

apollo-router/src/services/fetch.rs

@@ -1,4 +1,4 @@
-#![allow(missing_docs)] // FIXME
+//! Fetch request and response types.
 
 use std::sync::Arc;
 

apollo-router/src/services/fetch_service.rs

@@ -29,6 +29,8 @@ use crate::services::FetchResponse;
 use crate::services::SubgraphServiceFactory;
 use crate::spec::Schema;
 
+/// The fetch service delegates to either the subgraph service or connector service depending
+/// on whether connectors are present in the subgraph.
 #[derive(Clone)]
 pub(crate) struct FetchService {
     pub(crate) subgraph_service_factory: Arc<SubgraphServiceFactory>,