Wording improvements for appservices

api/application-service/application_service.yaml

@@ -33,9 +33,9 @@ paths:
         This API is called by the homeserver when it wants to push an event
         (or batch of events) to the application service.
 
-        The application service should take care to ensure that it handles
+        Note that the application service should distinguish state events
-        state events by the presence of a ``state_key``, not by the event
+        from message events via the presence of a ``state_key``, rather than
-        type.
+        via the event type.
       operationId: sendTransaction
       parameters:
         - in: path

specification/application_service_api.rst

@@ -224,7 +224,7 @@ need to be able to adjust the ``origin_server_ts`` value to do this.
 
 Inputs:
  - Application service token (``as_token``)
- - Desired timestamp in milliseconds since the unix epoch
+ - Desired timestamp (in milliseconds since the unix epoch)
 
 Notes:
  - This will only apply when sending events.