DOC: Move API breaking to appropriate sections
As discussed in https://github.com/pandas-dev/pandas/issues/34801, this moves some items from our "API breaking changes" section to either bug fixes or enhancements. I've only moved the ones we can hopefully get consensus on as bug fix / enhancement. But let me know if any of these need further discussion on whether they're an API breaking change.
