[FLINK-28140][python][docs] Improve the documentation connector pages and metrics pages

This closes #20385.
2 files changed