docs(persistence): rewrite generation-persistence for clarity + when-to-use