add/update docstring

ckan/cli/notify.py

@@ -4,7 +4,7 @@
 import click
 from ckan.model import Session, Package, DomainObjectOperation
 from ckan.model.modification import DomainObjectModificationExtension
-from ckan.views.resource import NotAuthorized, ValidationError
+from ckan.logic import NotAuthorized, ValidationError
 
 
 log = getLogger(__name__)
@@ -24,6 +24,17 @@ def replay():
 
 @notify.command(name="send_emails", short_help="Send out Email notifications.")
 def send_emails():
+    """
+    As currently implemented, it will only send notifications from dashboard 
+    activity list.
+
+    It will send emails to users who have `activity_streams_email_notifications`
+    set in their profile.
+
+    It will send emails with updates depending on how `ckan.email_notifications_since` 
+    is configured.
+    The default value is 2 days.
+    """
     import ckan.logic as logic
     import ckan.lib.mailer as mailer
     from ckan.types import Context

ckan/logic/action/update.py

@@ -1140,8 +1140,8 @@ def dashboard_mark_activities_old(
 def send_email_notifications(context: Context, data_dict: DataDict) -> ActionResult.SendEmailNotifications:
     '''Send any pending activity stream notification emails to users.
 
-    You must provide a sysadmin's API key in the Authorization header of the
-    request, or call this action from the command-line via a `paster post ...`
+    You must provide a sysadmin's API key/token in the Authorization header of the
+    request, or call this action from the command-line via a `ckan notify send_emails ...`
     command.
 
     '''