maintenance: improved python scripts
improved docs
package version bump