begin documenting data quirks in one place

I feel like I was repeating myself trying to explain quirks every
place in the code.
document some enrollment data quirks