Expand the doc blocks on the new methods

lib/private/activitymanager.php

@@ -127,6 +127,15 @@ class ActivityManager implements IManager {
 	}
 
 	/**
+	 * Generates a new IEvent object
+	 *
+	 * Make sure to call at least the following methods before sending it to the
+	 * app with via the publish() method:
+	 *  - setApp()
+	 *  - setType()
+	 *  - setAffectedUser()
+	 *  - setSubject()
+	 *
 	 * @return IEvent
 	 */
 	public function generateEvent() {
@@ -136,6 +145,12 @@ class ActivityManager implements IManager {
 	/**
 	 * Publish an event to the activity consumers
 	 *
+	 * Make sure to call at least the following methods before sending an Event:
+	 *  - setApp()
+	 *  - setType()
+	 *  - setAffectedUser()
+	 *  - setSubject()
+	 *
 	 * @param IEvent $event
 	 * @return null
 	 * @throws \BadMethodCallException if required values have not been set

lib/public/activity/imanager.php

@@ -39,12 +39,29 @@ namespace OCP\Activity;
  */
 interface IManager {
 	/**
+	 * Generates a new IEvent object
+	 *
+	 * Make sure to call at least the following methods before sending it to the
+	 * app with via the publish() method:
+	 *  - setApp()
+	 *  - setType()
+	 *  - setAffectedUser()
+	 *  - setSubject()
+	 *
 	 * @return IEvent
 	 * @since 8.2.0
 	 */
 	public function generateEvent();
 
 	/**
+	 * Publish an event to the activity consumers
+	 *
+	 * Make sure to call at least the following methods before sending an Event:
+	 *  - setApp()
+	 *  - setType()
+	 *  - setAffectedUser()
+	 *  - setSubject()
+	 *
 	 * @param IEvent $event
 	 * @return null
 	 * @since 8.2.0