example working all the way to started containers

- lots of bug fixes
- added jsdocs
- start port for host not working, but what makes docker pick one automatically which may be the better option