Updates doc according to issue #2