CHOP-52. Update README to read like a quickstart guide.

Reviewed by: kiyan
Update versions of kiji-schema, fake-hbase in pom.

Reviewed by: kiyan (over the shoulder)
Fixed type erasure warnings.

Reviewed by: kiyan
CHOP-83. Revise Scaladocs for Resources.