updated docs for issue #24