Suggestions for more detailed description of Constants.

@matzew Yeah, we can do that. I was thinking if it would make more sense to move the description of each constant into javadocs, to save people having to flip back to the README.md to see what they mean.