BISERVER-8052 - re-adding some method comment detail