DOC: Fix errors in pandas.DataFrame.melt
- [ ] closes #xxxx
- [ ] tests added / passed
- [x] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry


Related to #27977. 

output of `python scripts/validate_docstrings.py pandas.DataFrame.melt`:
```
################################################################################
################################## Validation ##################################
################################################################################
