update documentation due to current code state