Finish README, fixes #1

part of the github tutorial