Allow fall backs for moderation actions.

The `moderation_action` for members and nonmember can now be ``None``
which signals falling back to the appropriate list default action,
e.g. `default_member_action` and `default_nonmember_action`.  Given by
Aurélien Bompard.

Closes #189

1 files changed, 6 insertions, 2 deletions

diff --git a/src/mailman/rest/docs/membership.rst b/src/mailman/rest/docs/membership.rst
index ec8765d68..24065ba07 100644
--- a/src/mailman/rest/docs/membership.rst
+++ b/src/mailman/rest/docs/membership.rst
@@ -926,8 +926,8 @@ Moderating a member
 ===================
 
 The moderation action for a member can be changed by PATCH'ing the
-`moderation_action` attribute.
-::
+`moderation_action` attribute.  When the member action falls back to the list
+default, there is no such attribute in the resource.
 
     >>> dump_json('http://localhost:9001/3.0/members/10')
     address: http://localhost:9001/3.0/addresses/hperson@example.com
@@ -940,6 +940,10 @@ The moderation action for a member can be changed by PATCH'ing the
     self_link: http://localhost:9001/3.0/members/10
     user: http://localhost:9001/3.0/users/7
 
+Patching the moderation action both changes it for the given user, and adds
+the attribute to the member's resource.
+::
+
     >>> dump_json('http://localhost:9001/3.0/members/10', {
     ...           'moderation_action': 'hold',
     ...           }, method='PATCH')