resolve all sphinx complaints, document and link to operators in algebra.rst