From 4354fb80bb94d8b054f3d036f5ae1c34b1f26c61 Mon Sep 17 00:00:00 2001
From: David Baker <david.baker@openmarket.com>
Date: Thu, 16 Oct 2014 11:36:06 +0100
Subject: [PATCH] Make documentation of PUT alternatives consistent and add it
 where it was missing.

---
 swagger/client-server/api-docs-rooms | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/swagger/client-server/api-docs-rooms b/swagger/client-server/api-docs-rooms
index b941e581..832a1dae 100644
--- a/swagger/client-server/api-docs-rooms
+++ b/swagger/client-server/api-docs-rooms
@@ -491,7 +491,7 @@
         {
           "method": "POST",
           "summary": "Join a room via a room alias or room ID.",
-          "notes": "Join a room via a room alias or room ID.",
+          "notes": "This endpoint, unlike /rooms/{roomId}/join allows the client to join a room by it's alias. This operation can also be done as a PUT by suffixing /{txnId}.",
           "type": "JoinRoomInfo",
           "nickname": "join",
           "consumes": [
@@ -521,7 +521,7 @@
         {
           "method": "POST",
           "summary": "Create a room.",
-          "notes": "Create a room.",
+          "notes": "Create a room. This operation can also be done as a PUT by suffixing /{txnId}.",
           "type": "RoomInfo",
           "nickname": "create_room",
           "consumes": [
@@ -530,7 +530,7 @@
           "parameters": [
             {
               "name": "body",
-              "description": "The desired configuration for the room. This operation can also be done as a PUT by suffixing /{txnId}.",
+              "description": "The desired configuration for the room.",
               "required": true,
               "type": "RoomConfig",
               "paramType": "body"