docs: docstring improvements
docs: added sphinx extension
docs: updated documentation

    - documented metrics, utilities, and flag evaluation