Improve documentation for the data format

[ayust]

Specifically, note the conditions for setting each of the boolean fields, and clarifying which URL should be used for documentation in cases where there are multiple (e.g. a blog post that also links to an EEO-1).