new doc on creating operators

plus additional cleanup of docs.