TYP/DOC: fix flavor param with incorrect type hint in read_html
resolve #55059

Thanks @matheusfelipeog ! Thanks for the review and merge @twoertwein. Should pandas-stubs also be updated accordingly? You are welcome to also open a PR at pandas-stubs