some documentation tweaks
fix issue #28