tileradotorg/synapse
1
0
Fork 0
forked from MirrorHub/synapse
Code Pull requests Activity

howto: Link jsfiddles correctly. Hide ugly TODOs.

Browse source
This commit is contained in:
Kegan Dougal 2014-09-03 09:14:16 +01:00
parent 84430a4a8a
commit 8c793e0704
1 changed files with 22 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
docs/client-server/howto.rst
View file

@ -1,4 +1,5 @@
TODO(kegan): Room config (specifically: message history,
.. TODO kegan
Room config (specifically: message history,
public rooms). /register seems super simplistic compared to /login, maybe it
would be better if /register used the same technique as /login? /register should
be "user" not "user_id".
@ -21,7 +22,9 @@ Accounts
Before you can send and receive messages, you must **register** for an account.
If you already have an account, you must **login** into it.
**Try out the fiddle: http://jsfiddle.net/4q2jyxng/**
`Try out the fiddle`__
.. __: http://jsfiddle.net/4q2jyxng/
Registration
------------
@ -82,7 +85,9 @@ Communicating
In order to communicate with another user, you must **create a room** with that
user and **send a message** to that room.
**Try out the fiddle: http://jsfiddle.net/zL3zto9g/**
`Try out the fiddle`__
.. __: http://jsfiddle.net/zL3zto9g/
Creating a room
---------------
@ -100,7 +105,8 @@ The "room alias" is a human-readable string which can be shared with other users
so they can join a room, rather than the room ID which is a randomly generated
string. You can have multiple room aliases per room.
TODO(kegan): How to add/remove aliases from an existing room.
.. TODO(kegan)
How to add/remove aliases from an existing room.
Sending messages
@ -129,7 +135,9 @@ these rules may specify if you require an **invitation** from someone already in
the room in order to **join the room**. In addition, you may also be able to
join a room **via a room alias** if one was set up.
**Try out the fiddle: http://jsfiddle.net/7fhotf1b/**
`Try out the fiddle`__
.. __: http://jsfiddle.net/7fhotf1b/
Inviting a user to a room
-------------------------
@ -173,7 +181,9 @@ An event is some interesting piece of data that a client may be interested in.
It can be a message in a room, a room invite, etc. There are many different ways
of getting events, depending on what the client already knows.
**Try out the fiddle: http://jsfiddle.net/vw11mg37/**
`Try out the fiddle`__
.. __: http://jsfiddle.net/vw11mg37/
Getting all state
-----------------
@ -621,4 +631,6 @@ creating and joining rooms, sending messages, getting member lists and getting
historical messages for a room. This covers most functionality of a messaging
application.
**Try out the fiddle: http://jsfiddle.net/uztL3yme/**
`Try out the fiddle`__
.. __: http://jsfiddle.net/uztL3yme/