Improve the documentation for Analyzers (some terminology was not correct) also fix some broken links along the way. Note: this commit is a spin-off of #6252 Signed-off-by: Lukáš Vlček <lukas.vlcek@aiven.io>