docs improvements

See issue #23