Readme-edits, fixes #1

Technical content for developers