add comments to the server spec file
minor format edits in README.md