Update and move example to examples/basic-example

Do not install pycommand-example as a script anymore, but offer a well
documented example to be installed outside of the users $PATH.
Add doctests
Add sphinx documentation and update description
Add PKGBUILD (draft) for archlinux