Improve API docs

[jeriox]

• [ ] mention swagger view
• [ ] think about whether we want to keep the current rudimentary docs or host a central swagger instead
• [x] add authorization docs to swagger
• [ ] fix participation user drf-spectacular warnings on schema creation