Better docs

README.md

@@ -364,7 +364,7 @@ import org.racehorse.ActivityPlugin
 EventBus.getDefault().register(ActivityPlugin().also { enable() })
 ```
 
-3. Start the activity, for example to open settings app and navigate user to the notification settings:
+3. Start a new activity. For example, here's how to open Settings app and navigate user to the notification settings:
 
 ```ts
 import { activityManager, Intent } from 'racehorse';
@@ -378,7 +378,7 @@ activityManager.startActivity({
 });
 ```
 
-4. Synchronously read the activity status or subscribe to its changes:
+4. Synchronously read the status of the current activity or subscribe to its changes:
 
 ```ts
 import { activityManager, ActivityState } from 'racehorse';

android/racehorse/src/main/java/org/racehorse/ActivityPlugin.kt

@@ -40,9 +40,10 @@ class StartActivityForResultEvent(val intent: SerializableIntent) : RequestEvent
 }
 
 /**
- * Opens URL in an external app.
+ * Launches activities for various intents, and provides info about the current activity.
  *
  * @param activity The activity that launches the intent to open a URL.
+ * @param eventBus The event bus to which events are posted.
  */
 open class ActivityPlugin(
     private val activity: ComponentActivity,

web/racehorse/src/main/createActivityManager.ts

@@ -184,7 +184,7 @@ const eventTypeToActivityState = {
 } as const;
 
 /**
- * Launches activities for various intents.
+ * Launches activities for various intents, and provides info about the current activity.
  *
  * @param eventBridge The underlying event bridge.
  */