use parallel assignment
update docs