Closes #xxxx Tests added Added clear title that can be used to generate release notes Fully documented, including updating docs/source/*.rst for new API