documentation updates
more docs fixes
workaround for sweep not updating properly