readme.md update
Cleanups + javadocs
Update ‘score’ entity