put back hosts (per pull request comments)
added some documentation entries