=per #15429 Rewrite persistence documentation and samples for 2.3.4 changes

yeah, I'm out of energy for changing more of those (second round of cleanup will come when deprecated things are removed)