Clarify docs and resolve one warning

docker/supervisord.conf

@@ -6,6 +6,9 @@ childlogdir = exec/logs
 # 5 MB log file with 10 backup files
 logfile_maxbytes = 5000000
 logfile_backups = 10
+# We always run as root in docker, which causes supervisor to throw an error. It is silenced by
+# telling it that we explicitly are intended to run as root.
+user = root
 
 # the below section must remain in the config file for RPC
 # (supervisorctl/web interface) to work, additional interfaces may be

overwatch/base/deploy.py

@@ -1418,7 +1418,6 @@ def setup(self):
         # Create an underlying uwsgi app to handle the setup and execution.
         if "nginx" in self.config:
             if self.config["nginx"].get("enabled", False) is True:
-                # TODO: Either pass the http or unix socket
                 self.nginx = nginx(self.config["nginx"])
                 self.nginx.run()
 

overwatch/base/deployReference.yaml

@@ -184,11 +184,13 @@ executables:
             enabled: false
             # Module path of the web app.
             module: "overwatch.webApp.run"
+            # Must specify either a http-socket or a uwsgi-socket.
         nginx:
             <<: *nginxOptions
             enabled: false
             # Name of the web app
             webAppName: "webApp"
+            # NOTE: If this is working with uwsgi, wsgi-socket should be set to "/tmp/sockets/{webAppName}.sock"!
 
         # Additional options to be passed into the Overwatch config. Any entries should be valid
         # Overwatch config YAML. It will be stored in the user `config.yaml`.