TOOLS-709: eng.git notes on using .restdown files is out of date
[doc] note joyent employee only resources.
[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.