Tidying generator filter documentation

Following a discussion on offline help (https://atlas-talk.web.cern.ch/t/problems-with-the-met-filter-and-photon-filter-for-a-susy-jo/44195/5), updating the documentation of the generator filters a bit to try to use better markdown syntax and be a little more clear and firm about what people should do.