[#518] aligned documentation with the current implementation