updating docs regarding problem