About latest thread on better naming and documentation improvement, why
don't organize an interactive session where:
1) normal users tell what's wrong about a package/module documentation
2) the package/module author/maintainer fix the documentation in real
time, so that users can review it again
Manlio Perillo