 
   // MARK: - Public methods
 
-  /***/
+  /**
+   This method has two separate but related functions.
+
+   It's first function is to begin advertising the Thali peer's presence to other peers.
+
+   The second purpose is to bridge outgoing non-TCP/IP connections to TCP/IP port.
+   
+   - parameters:
+     - port:
+       Pre-configured localhost port that a native TCP/IP client should
+       use to bridge outgoing non-TCP/IP connection.
+
+     - errorHandler:
+       Called when startUpdateAdvertisingAndListening fails.
+   */
   public func startUpdateAdvertisingAndListening(onPort port: UInt16,
-                                                        errorHandler: ErrorType -> Void) {
+                                                 errorHandler: ErrorType -> Void) {
     if let currentAdvertiser = currentAdvertiser {
       disposeAdvertiserAfterTimeoutToFinishInvites(currentAdvertiser)
     }

    currentAdvertiser = nil
  }

  /***/
  public func hasAdvertiser(with identifier: String) -> Bool {
    return advertisers.value.filter { $0.peer.uuid == identifier }
      .count > 0
  }

  // MARK: - Private methods

  /***/
  private func disposeAdvertiserAfterTimeoutToFinishInvites(
    advertiserShouldBeDisposed: Advertiser) {


                                    let relay = AdvertiserRelay(with: session, on: port)
                                    $0[newPeer.uuid] = relay
                                  }
                                },
                                sessionNotConnected: {
                                  [weak self] in
                                  guard let strongSelf = self else { return }
