documentation improvements

resolves #124