fix documentation consistent with comments

Roll back change to changelog.rst to fix IDE issue, update change log
with bug details and remove same detail from upgrade guide.