Improved documentation.

lib/falcon/environment/application.rb

@@ -9,6 +9,7 @@
 
 module Falcon
 	module Environment
+		# Provides an environment for hosting a web application that uses TLS.
 		module Application
 			include Server
 

lib/falcon/environment/lets_encrypt_tls.rb

@@ -8,7 +8,7 @@
 
 module Falcon
 	module Environment
-		# A Lets Encrypt SSL context environment.
+		# Provides an environment that uses "Lets Encrypt" for TLS.
 		module LetsEncryptTLS
 			# The Lets Encrypt certificate store path.
 			# @parameter [String]

lib/falcon/environment/proxy.rb

@@ -10,6 +10,7 @@
 
 module Falcon
 	module Environment
+		# Provides an environment for hosting a TLS-capable reverse proxy using SNI.
 		module Proxy
 			include Server
 
@@ -29,6 +30,8 @@ def environments
 				[]
 			end
 
+			# The hosts we will proxy to. This is a hash of SNI authority -> evaluator.
+			# @returns [Hash(String, Async::Service::Environment::Evaluator)]
 			def hosts
 				hosts = {}
 

lib/falcon/environment/rack.rb

@@ -9,6 +9,7 @@
 
 module Falcon
 	module Environment
+		# Provides an environment for hosting a web application that use a Rackup `config.ru` file.
 		module Rack
 			include Application
 			include Rackup

lib/falcon/environment/rackup.rb

@@ -8,6 +8,7 @@
 
 module Falcon
 	module Environment
+		# Provides an environment for hosting loading a Rackup `config.ru` file.
 		module Rackup
 			def rackup_path
 				'config.ru'

lib/falcon/environment/redirect.rb

@@ -8,7 +8,7 @@
 
 module Falcon
 	module Environment
-		# A controller for redirecting requests.
+		# Provides an environment for redirecting insecure web traffic to a secure endpoint.
 		module Redirect
 			include Server
 

lib/falcon/environment/self_signed_tls.rb

@@ -9,7 +9,7 @@
 
 module Falcon
 	module Environment
-		# A general SSL context environment.
+		# Provides an environment that exposes a self-signed TLS certificate using the `localhost` gem.
 		module SelfSignedTLS
 			# The default session identifier for the session cache.
 			# @returns [String]

lib/falcon/environment/server.rb

@@ -11,6 +11,7 @@
 
 module Falcon
 	module Environment
+		# Provides an environment for hosting a web application that uses a Falcon server.
 		module Server
 			# The service class to use for the proxy.
 			# @returns [Class]

lib/falcon/environment/supervisor.rb

@@ -8,7 +8,7 @@
 
 module Falcon
 	module Environment
-		# A application process monitor environment.
+		# Provides an environment for hosting a supervisor which can monitor multiple applications.
 		module Supervisor
 			# The name of the supervisor
 			# @returns [String]

lib/falcon/environment/tls.rb

@@ -8,7 +8,7 @@
 
 module Falcon
 	module Environment
-		# A general SSL context environment.
+		# Provides an environment that exposes a TLS context for hosting a secure web application.
 		module TLS
 			# The default session identifier for the session cache.
 			# @returns [String]