various doc improvements
see also
bump version; changelog
Added tag 0.001 for changeset fc2940cd1c80