Updated the readme with some friendlier developer-facing documnetation.