DOC: expanded pandas.DataFrame.to_sql docstring
- [x] closes #54712
- [x] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).

Implements the suggested fix from @mattatark to `pandas.DataFrame.to_sql`

Thanks @pauluhlenbruck 