Add docs to match code changes from #623
Add docs to match code changes from #623