More docs

Author: michaelklishin

projects/client/RabbitMQ.Client/src/client/api/ConnectionFactory.cs

@@ -310,11 +310,27 @@ public AuthMechanismFactory AuthMechanismFactory(IList<string> mechanismNames)
         /// <summary>
         /// Create a connection to the specified endpoint.
         /// </summary>
+        /// <exception cref="BrokerUnreachableException">
+        /// When the configured hostname was not reachable.
+        /// </exception>
         public virtual IConnection CreateConnection()
         {
             return CreateConnection(new List<string>() { HostName });
         }
 
+        /// <summary>
+        /// Create a connection using a list of hostnames. The first reachable
+        /// hostname will be used initially. Subsequent hostname picks are determined
+        /// by the <see cref="IHostnameSelector" /> configured.
+        /// </summary>
+        /// <param name="hostnames">
+        /// List of hostnames to use for the initial
+        /// connection and recovery.
+        /// </param>
+        /// <returns>Open connection</returns>
+        /// <exception cref="BrokerUnreachableException">
+        /// When no hostname was reachable.
+        /// </exception>
         public IConnection CreateConnection(IList<string> hostnames)
         {
             IConnection conn;