doc updates (should fix issue #24)