From 047355b5c9d69b34bfe09e44800c1d41d12c2185 Mon Sep 17 00:00:00 2001 From: Kegan Dougal Date: Fri, 6 Feb 2015 13:05:28 +0000 Subject: [PATCH] More syntax fixes --- drafts/typing_notifications.rst | 2 +- drafts/use_cases.rst | 17 ++++++++++------- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/drafts/typing_notifications.rst b/drafts/typing_notifications.rst index 3d3d23e0..048eba98 100644 --- a/drafts/typing_notifications.rst +++ b/drafts/typing_notifications.rst @@ -7,7 +7,7 @@ Client APIs To set "I am typing for the next N msec":: PUT .../rooms/:room_id/typing/:user_id Content: { "typing": true, "timeout": N } - # timeout is in msec; I suggest no more than 20 or 30 seconds + # timeout is in msec; I suggest no more than 20 or 30 seconds This should be re-sent by the client to continue informing the server the user is still typing; I suggest a safety margin of 5 seconds before the expected diff --git a/drafts/use_cases.rst b/drafts/use_cases.rst index 955db4b3..09172d49 100644 --- a/drafts/use_cases.rst +++ b/drafts/use_cases.rst @@ -268,6 +268,7 @@ Chat Screen What's visible: - Enough scrollback to fill a "screen full" of content. - Threads: + - Initially will only display the timestamp and user ID of the *first* message. But can expand to show the entire tree. - Tree of messages indicating which message is a reply to which. @@ -280,6 +281,7 @@ Chat Screen - Desktop/Push Notifications for messages What you can do: - Send a message in reply to another message: + - Immediate local echo, may cause messages to re-order - Messages that haven't reached the server are queued. - Thread is displayed where it should be in the thread order once the @@ -296,13 +298,14 @@ Chat Screen The columns start and end as threads split and rejoin the main conversation The messages for each thread are ordered by how recent they are:: - Room #1 Room # 2 Room # 2 - +------------+ +----------------+ Side thread. - | * Message1 | | * Root | +--------------+ - | * Message2 | | * A1 -> Root | | * B1 -> Root | - +------------+ | * A2 -> A1 | | * B2 -> B1 | - | * M -> A2, B2 | +--------------+ - +----------------+ + Room #1 Room # 2 Room # 2 + +------------+ +----------------+ Side thread. + | * Message1 | | * Root | +--------------+ + | * Message2 | | * A1 -> Root | | * B1 -> Root | + +------------+ | * A2 -> A1 | | * B2 -> B1 | + | * M -> A2, B2 | +--------------+ + +----------------+ + - Typing notifications. Displayed within the correct thread/column. What you can do: