Update documentation regarding issue #2