add polar files and improve polar file loading
bump version
update documentation