Add docstring to the insertion method & add empty result note
closes #21364 
closes #26868 
- [x] tests passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- **What's new?** Some small fixes in documentation.
