i have added a persistence.txt file in the doc directory (which serves as a kind of wiki page) that explains some parts of the persistence architecture.

it's a bit conceise so feel free to ask more explanation if you're interested in a certain part.