model persistence doc, added improvements from ogrisel comments