wagtail
Adding documentation for moderation
I searched through the current docs for "how moderation works in wagtail", but all could find was http://docs.wagtail.io/en/v2.0/editor_manual/new_pages/previewing_and_submitting_for_moderation.html, which explains how to submit a page for moderation, but does not contain any information on what's supposed to happen then.
Would it be possible to add some more pages to the docs? Specfically, information that would be good to also have:
- who can moderate (is it a group policy checkbox? I didn't see one but I might be missing a setting of course)
- where do notifications end up? (is there an 'inbox' in wagtail? email? if so, how's that set up within the context of moderation? etc)
- where is the moderation queue? (if there is one?)
- how does accept/reject work
- when you update a submitted-for-moderation draft and you save the update, what happens to the moderation request for the previous draft?
Hello I’m jadesola an outreachy applicant👋🏾
I’d like to work on this if that’s okay @gasman @thibaudcolas
@jadesola123 Moderation is no longer used but instead has been replaced with Workflow.
See
- https://docs.wagtail.org/en/stable/editor_manual/administrator_tasks/managing_workflows.html
- https://docs.wagtail.org/en/stable/reference/pages/model_reference.html#workflow
- https://docs.wagtail.org/en/v4.0.2/extending/custom_tasks.html
- https://docs.wagtail.org/en/v4.0.2/releases/2.10.html#moderation-workflow
it's possible that this issue is no longer required or maybe the existing docs sections could do with a bit more detail.
Some specific notes below, but please do your own investigation and see what we could improve to get this issue resolved.
- who can moderate (is it a group policy checkbox? I didn't see one but I might be missing a setting of course)
- This is now controlled in the admin so is probably covered in the user guide.
- where do notifications end up? (is there an 'inbox' in wagtail? email? if so, how's that set up within the context of moderation? etc)
- This may be covered by the task type adding notifications but maybe it needs to be written somewhere else (see the notifications part)
- where is the moderation queue? (if there is one?)
- This is probably covered in the WorkflowState model definition.
- how does accept/reject work
- Also part of the workflow state model
- when you update a submitted-for-moderation draft and you save the update, what happens to the moderation request for the previous draft?
- This could be documented, if not already, in the user guide I guesss
