updates docs to fix #2240