fixed #1801
fixes #1809 so that the REST API can be navigated easily in a browser using links in the JSON; to make things more HATEOS and so folks don't have to remember the URI patterns
removed cruft
updated to the latest docker way to configure the env var
added a FAQ entry on adding a container to an ensemble