From 5b5b4cfbed2941e342dc06678d39bf00ec50d0f7 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Fri, 17 Aug 2018 13:38:38 -0600
Subject: [PATCH] Explicitly say how appservices should detect state events

Fixes https://github.com/matrix-org/matrix-doc/issues/1014
---
 api/application-service/application_service.yaml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/api/application-service/application_service.yaml b/api/application-service/application_service.yaml
index 42c0c0cf..64064cbd 100644
--- a/api/application-service/application_service.yaml
+++ b/api/application-service/application_service.yaml
@@ -32,6 +32,10 @@ paths:
       description: |-
         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
+        state events by the presence of a ``state_key``, not by the event
+        type.
       operationId: sendTransaction
       parameters:
         - in: path
@@ -44,7 +48,7 @@ paths:
           x-example: "35"
         - in: body
           name: body
-          description: A list of events
+          description: A list of events.
           schema:
             type: object
             example: {