DOC: Add examples and notes to empty documentation
- [x] closes #12393 
- [x] passes `git diff upstream/master | flake8 --diff`

Added notes and examples to provide clarity around the issue discussed in #12393. This is my first contribution to pandas, so let me know if I need to fix anything.
