doc changes and updates to better support needed functions