document how the harvester works

[kpsherva]

• mention the shifting problem (needs to be well explained, take the original GH issue explanation
• mention the priority of the resource types
• mention when do we split into different versions and why
• mention which fields do we map