Python entrypoints vs worker_app are very confusing #13644
Description
We define various "application worker types", such as synapse.app.generic_worker and synapse.app.federation_sender. Which you get is determined by the worker_app configuration setting.
However, for historical reasons, we also have a bunch of entrypoints with matching names: python -m synapse.app.generic_worker or python -m synapse.app.federation_sender. These all do the same thing, but the fact that they exist, and have the same names as the workers, makes the interaction very confusing. We don't make it clear which entrypoint you should use. Possibly we could recommend synapse.app.generic_worker, but that's still confusing.
I think the easiest way out of it is to create a new entrypoint - synapse.app.worker, maybe - which is yet another copy of the existing entrypoints. Then we can deprecate the old names.