[doc] TOOLS-594 eng update README.md.

- `rm server.js`: stale worse than nothing.
- Sub-headings markdown.
- Added sections based on what's used in real Joyent repos
  including renaming "Repository/Directory" section to "Code Layout".
This is good news. I agree it is too little signal for the readme.