Browse Source

Fix a few docs (#2168)

George Barnett 1 year ago
parent
commit
32d17fb9f5
1 changed files with 7 additions and 6 deletions
  1. 7 6
      Sources/GRPCCore/GRPCServer.swift

+ 7 - 6
Sources/GRPCCore/GRPCServer.swift

@@ -34,8 +34,8 @@ private import Synchronization
 /// The following example demonstrates how to create and run a server.
 ///
 /// ```swift
-/// // Create an transport
-/// let transport: any ServerTransport = ...
+/// // Create a transport
+/// let transport = SomeServerTransport()
 ///
 /// // Create the 'Greeter' and 'Echo' services.
 /// let greeter = GreeterService()
@@ -73,7 +73,8 @@ private import Synchronization
 /// This allows the server to drain existing requests gracefully. To stop the server more abruptly
 /// you can cancel the task running your server. If your application requires additional resources
 /// that need their lifecycles managed you should consider using [Swift Service
-/// Lifecycle](https://github.com/swift-server/swift-service-lifecycle).
+/// Lifecycle](https://github.com/swift-server/swift-service-lifecycle) and the
+/// `GRPCServiceLifecycle` module provided by [gRPC Swift Extras](https://github.com/grpc/grpc-swift-extras).
 public final class GRPCServer<Transport: ServerTransport>: Sendable {
   typealias Stream = RPCStream<Transport.Inbound, Transport.Outbound>
 
@@ -136,7 +137,7 @@ public final class GRPCServer<Transport: ServerTransport>: Sendable {
     }
   }
 
-  /// Creates a new server with no resources.
+  /// Creates a new server.
   ///
   /// - Parameters:
   ///   - transport: The transport the server should listen on.
@@ -158,7 +159,7 @@ public final class GRPCServer<Transport: ServerTransport>: Sendable {
     )
   }
 
-  /// Creates a new server with no resources.
+  /// Creates a new server.
   ///
   /// - Parameters:
   ///   - transport: The transport the server should listen on.
@@ -182,7 +183,7 @@ public final class GRPCServer<Transport: ServerTransport>: Sendable {
     self.init(transport: transport, router: router)
   }
 
-  /// Creates a new server with no resources.
+  /// Creates a new server with a pre-configured router.
   ///
   /// - Parameters:
   ///   - transport: The transport the server should listen on.