Add docs for changes in #726
Merge pull request #750 from edx/peterb/numerical/add-docs

Add docs for changes in #726