update documentation follwing recent changes