fixed doc and takes into account remarks from 345th PR