honor persist configuration
update documentation