better param names
adding first maybe example
cleanup namespaces
better documentation