docs: detail pkg discover guide and namespace pkg

userguide/pkg_discovery.txt now covers find_package,
find_namespace package and legacy use of namespace
package creation in both setup.py and setup.cfg style