cc52f02d74
Fix rst
2015-04-28 18:09:20 +01:00
3151afee9e
Update docs/postgres.rst to explain port script usage
2015-04-28 17:59:27 +01:00
56f518d279
Add docs on how to use synapse with psycopg2
2015-04-27 14:53:35 +01:00
6d15401341
Mumble ReST mumble ``fixed-width`` mumble
2015-04-23 16:16:08 +01:00
8c78414284
Formatting / wording fixes to metrics doc
2015-04-23 16:14:08 +01:00
6c99491347
prometheus/metrics howto from Leo
2015-04-23 16:08:08 +01:00
e60353c4a0
Fix YAML syntax of turn config example
2015-02-24 19:34:21 +00:00
1eb319806b
clarify these instructions a media-repo specific
2014-12-24 16:56:32 +00:00
4f37c0ea9d
Merge branch 'develop' into media_repository
2014-12-10 16:55:06 +00:00
7f193b9958
update media repository implementation docs
2014-12-10 16:54:37 +00:00
8ffbb52eee
oops
2014-12-10 13:43:34 +00:00
32bc2b4fc1
update codestyle based on debate on #matrix-dev
2014-12-10 13:11:43 +00:00
279c48c8b4
Write the upload portion of version 1 of the media repository
2014-12-02 17:13:14 +00:00
33e9e0fb2d
move model/ into matrix-doc/drafts
2014-11-12 01:16:38 +02:00
ef1eb4c888
this got merged into matrix-doc/specification/00_basis.rst by someone
2014-11-12 01:14:06 +02:00
0ac2dc388e
move OLD_specification into matrix-doc/drafts
2014-11-12 01:04:32 +02:00
a0bc0fdf21
vestigial readme for sphinx
2014-11-12 00:18:26 +02:00
774cff3c72
move swagger impl to matrix-doc
2014-11-12 00:18:25 +02:00
0c59bc5e35
move stuff out of implementation-notes - /everything/ here should be implementation-notes now
2014-11-12 00:18:25 +02:00
7e1779d48c
this is ancient and has been moved to matrix-doc/drafts/federated_versioning_design_notes.rst
2014-11-12 00:18:25 +02:00
b6c48a694b
haven't i already moved you to matrix-doc twice? :/
2014-11-12 00:18:25 +02:00
216d5f6b52
this is obsolete and lives in matrix-doc in specification/30_server_server_api.rst now
2014-11-12 00:17:06 +02:00
bebca337c4
this has been merged into matrix-doc/specification/30_server_server_api.rst
2014-11-12 00:17:05 +02:00
a8ceeec0fd
Merge pull request #12 from matrix-org/federation_authorization
...
Federation authorization
2014-11-11 16:40:50 +00:00
303b455965
trivial spacing fix
2014-11-11 04:39:30 +00:00
f45a6a7004
Fix RST sublist formatting bug
2014-11-10 22:07:08 +00:00
f987393b32
moar boxes.
2014-11-10 21:56:52 +00:00
0b51d970b4
document up the current architecture a bit based on the workshop the other week
2014-11-10 18:43:16 +00:00
acb2d171e8
Merge branch 'develop' into event_signing
2014-10-27 11:14:11 +00:00
a065becea5
Merge branch 'docs-restructuring' of github.com:matrix-org/synapse into develop
2014-10-17 20:18:02 +01:00
c5cec1cc77
Rename 'meta' to 'unsigned'
2014-10-17 16:50:04 +01:00
c18a6433d4
typoe
2014-10-13 23:24:14 +01:00
984e207b59
Merge branch develop into server2server_signing
...
Conflicts:
synapse/app/homeserver.py
2014-10-13 10:58:50 +01:00
259b5e8451
move swagger JSON from synapse project to matrix-doc project
2014-10-09 20:43:07 +02:00
e1170d4edb
move matrix-generic content to new matrix-doc git project
2014-10-09 20:38:00 +02:00
81b956c70d
Add spec-additions.rst with info on recaptcha and common event fields.
2014-10-09 18:08:19 +01:00
d224358e21
Restructure specification sections.
2014-10-09 11:08:06 +01:00
917af4705b
Clarify that room alias domain names will be server-scoped; nonlocal edits are unliekly to work but nonlocal lookups will
2014-10-07 16:23:12 +01:00
9ac53ef8cf
SPEC-3: First hack at defining some of the various event related concepts
2014-10-07 11:38:02 +01:00
2fc00508fb
Add quick and dirty doc about state resolution
2014-10-06 17:34:44 +01:00
c72074b48e
Clarify how-to some more.
2014-10-06 14:57:26 +01:00
3ef2c946d5
Update JSFiddles/how-to to support the new registration format.
2014-10-06 14:52:46 +01:00
aaf1d499bf
Add more section headings.
2014-10-06 13:18:52 +01:00
94982392be
Clarify room permission / power level information.
2014-10-06 12:41:48 +01:00
51276c60bf
Add information about the initialSync API.
...
Outline and describe the keys from the initial sync API. Hide room-scoped
initial sync API for now as it is not implemented and needs more thought before
it can be specced.
2014-10-06 10:32:04 +01:00
78a3f43d9d
swagger: Added DELETE method for directory server.
2014-10-06 09:23:19 +01:00
02a44664b9
More spec work.
2014-10-03 17:38:30 +01:00
1fa0454288
Merge pull request #6 from matrix-org/paul/doc
...
Clarify how m.room.alias event works
2014-10-03 14:50:08 +01:00
ca0e8dedfb
Clarify how m.room.alias event works
2014-10-03 14:45:42 +01:00
ba11afafb9
Flesh out room alias section.
2014-10-03 14:39:58 +01:00
7e1437c6b1
Add more information to TODOs. Explain m.room.join_rules.
2014-10-03 10:34:29 +01:00
1aa5cc9178
Federation protocol URLs should have an H2 heading, not H1
2014-10-02 18:11:04 +01:00
bc1d685a8c
Remove TODO note about VoIP events as they now have their own entire section
2014-10-02 18:00:31 +01:00
f6b9853ad0
Merge pull request #5 from matrix-org/paul/doc
...
Document the Profile system
2014-10-02 17:37:21 +01:00
de38f54f22
Document the Profile system
2014-10-02 17:18:32 +01:00
036333412d
Add todo notes
2014-10-02 14:38:53 +01:00
82e278029c
Remove incorrect reasons for empty PDU lists.
2014-10-02 14:38:22 +01:00
1561ef56ed
Remove note about assymetry of having left a room.
...
Currently, if you leave a room you still appear in the members list.
This is basically a bug with the current implementation/spec, rather
than something that should happen.
2014-10-02 14:35:39 +01:00
f368ad946e
m.room.ops_levels includes redact_level
2014-10-02 14:33:26 +01:00
918e71adb7
Don't use spaces in example room alias
2014-10-02 14:31:21 +01:00
cf3188352b
Fix default value and key names.
2014-10-02 14:30:25 +01:00
6860a18c12
Be less alarmist about not using an ID server.
2014-10-02 14:27:35 +01:00
ff553cc9dd
Alias lookups return a server list.
2014-10-02 14:26:58 +01:00
b2d41b1cd9
All room state is currently shared.
2014-10-02 14:25:47 +01:00
bf8b9b90cd
Added a TODO-doc marker about the presence timing system
2014-10-01 19:37:18 +01:00
c5757a0266
Define the client and server APIs for Presence
2014-10-01 19:35:13 +01:00
ee447abcad
Continue moving content out of docs/model/presence into the main spec; delete model docs that are duplicated
2014-10-01 18:34:08 +01:00
a940a87ddc
SPEC-25: Add details on how to prune redacted events.
...
SPEC-25 #comment I've added the details of what the server should do on
receipt of a redaction event. In reality it can do whatever it wants,
and its probably a reasonable implementation to flag it up to a server
admin for verification before actually redacting an event.
2014-10-01 18:18:44 +01:00
5813e81dc6
Move documented but-unimplemented 'presence idle times' into a new document to contain such features
2014-10-01 17:59:55 +01:00
a6d3be4dbf
s/m.room.redacted/m.room.redaction/
2014-10-01 17:55:31 +01:00
166bec0c08
Nuke the entire 'Typing Notifications' spec section given as they don't exist yet in the implementation
2014-10-01 17:33:18 +01:00
392dc8af59
Annotate all the 'TODO' marks as relating to either the specification itself or the documentation thereof
2014-09-30 18:11:24 +01:00
9605593d11
Merge branch 'develop' into server2server_signing
...
Conflicts:
synapse/storage/__init__.py
tests/rest/test_presence.py
2014-09-30 17:55:06 +01:00
1f76377a7c
Re-wrap content after latest additions
2014-09-29 18:40:15 +01:00
dca75a08ba
Merge remote-tracking branch 'origin/develop' into develop
2014-09-29 18:37:28 +01:00
2d61dbc774
Extended docs about the registration/login flows
2014-09-29 18:36:10 +01:00
3ee9a67aa4
Reörder the specification sections, to move 'Registration and Login' first, where it logically belongs
2014-09-29 18:36:10 +01:00
ae953b0884
Huge whitespace hackery - reflow all (content) paragraphs at tw=80
2014-09-29 18:36:10 +01:00
d5bf210998
No longer need the Freenode verification key file
2014-09-29 18:36:10 +01:00
389285585d
Add a 'Redactions' section.
2014-09-29 17:19:45 +01:00
3656eb4740
Add m.room.redacted in events list
2014-09-29 16:39:08 +01:00
472ef19100
No longer need the Freenode verification key file
2014-09-29 14:22:21 +01:00
ec5fb77a66
Just use a yaml list for turn servers
2014-09-25 19:18:32 +02:00
6e72ee62ae
Add realm to coturn options (it needs it).
2014-09-25 17:21:52 +01:00
48ea055781
fix rst warnings
2014-09-25 17:01:27 +01:00
9bcedf224e
add howto for setting up your very own TURN server
2014-09-25 16:58:21 +01:00
2771efb51c
Update API docs to include notes on /rooms/$roomid/state
2014-09-23 15:39:04 +01:00
6876b1a25b
fix grammatics
2014-09-22 21:45:50 +01:00
107e7d5d91
Add section to explain how to sign events such that we can redact message contents
2014-09-22 19:42:07 +01:00
09d79b0a9b
Merge branch 'develop' into server2server_signing
2014-09-22 18:54:00 +01:00
fceb5f7b22
SYN-39: Add documentation explaining how to check a signature
2014-09-18 18:15:50 +01:00
704e7e9f44
Merge branch 'release-v0.3.0' of github.com:matrix-org/synapse
2014-09-18 13:05:07 +01:00
9f94f9de48
freenode verification
2014-09-17 23:53:53 +01:00
f4094c5eb3
Update spec with the lifetime field.
2014-09-16 14:54:52 +01:00
0b8a3bc3b9
Update spec to include m.login.email.identity
2014-09-15 15:27:17 +01:00
bf6fa6dd3d
Merge branch 'develop' of github.com:matrix-org/synapse into registration-api-changes
2014-09-15 09:46:33 +01:00
21b45d2a5b
Update the spec document to replace the candidate message with the candidates message.
2014-09-12 18:19:19 +01:00
09a59ce2d3
Some words about glare
2014-09-12 14:24:56 +01:00
2bd4346075
More rst formatting.
2014-09-09 15:13:50 -07:00
f23e5b17b6
Extra restrictions to make parsing easier.
2014-09-09 15:11:06 -07:00
56a358481e
Tyops
2014-09-09 15:00:48 -07:00
d5704cf2a3
Added initial draft for human-readable ID rules.
2014-09-09 14:53:35 -07:00
550e8f32ac
Move model to client-server for now.
2014-09-09 13:51:13 -07:00
d692994ea4
Updated jsfiddle links to point to github
2014-09-08 14:16:22 -07:00
586e0df62d
Updated spec and api docs to desired new format.
2014-09-08 11:07:52 -07:00
7bff9b6269
Minor spec tweaks.
2014-09-08 11:28:50 +02:00
aa90e53312
add todo
2014-09-06 00:32:39 -07:00
684001ac62
Document new invite key added to createRoom api
2014-09-06 01:12:12 +01:00
fc65b68f30
Add m.roo.aliases
2014-09-05 22:01:10 +01:00
e0fa4cf874
Spelling
2014-09-05 18:22:24 +01:00
9243f0c5e3
Add docs on how to sign json
2014-09-05 17:42:54 +01:00
0d1d9f3e9c
merge spec changes
2014-09-04 23:16:04 -07:00
9c82276760
Add version 0 of the VoIP specification.
2014-09-04 18:20:27 +01:00
f196d77f66
Added federation protocol urls section from other docs.
2014-09-03 18:07:42 +01:00
5391ccdfe6
Marked docs/client-server/specification.rst as old.
2014-09-03 18:02:33 +01:00
f68dbbd3da
More explanation of federation keys.
2014-09-03 18:00:00 +01:00
79bf9d25db
Added more terms.
2014-09-03 17:48:08 +01:00
7c4ce957c7
Unindent list in specification to remove blockquote
2014-09-03 17:37:19 +01:00
f93aba1d66
Fix formating for threat model
2014-09-03 17:28:35 +01:00
e3b261b0b7
Move securitY threat model docs into specification
2014-09-03 17:26:16 +01:00
581c54bebe
Add exception handling to directory servlet, so we don't 500. Mark directory API as volatile in the api docs.
2014-09-03 16:27:01 +01:00
56bc57cf50
apidocs: Added m.room.name
2014-09-03 13:42:56 +01:00
27cdbf7b94
apidocs: Tweak join response format. Explicitly state empty JSON objects where they are required by the spec. Mark unimplemented room GET APIs clearly.
2014-09-03 13:32:33 +01:00
cd0afb85c4
Updated feedback api docs and fixed feedback content template bug
2014-09-03 13:08:17 +01:00
dfea1730dc
apidocs: mtime_age > last_active_ago. Presence REST: Sanity check values in invite/drop arrays.
2014-09-03 12:09:20 +01:00
c54d8df504
Update API docs to use 'presence' key not 'state'. Fixed error messages when setting presence.
2014-09-03 11:45:30 +01:00
3a3fadcece
Make API docs not lie on registration/login.
2014-09-03 10:58:53 +01:00
ce5c88006e
Update port numbers.
2014-09-03 10:47:07 +01:00
46ac4a2f85
Fill out power level bits in the spec
2014-09-03 10:44:46 +01:00
8ad056b207
Prefix API links with /docs/api/client-server so they should link through correctly on matrix.org
2014-09-03 10:32:51 +01:00
8c793e0704
howto: Link jsfiddles correctly. Hide ugly TODOs.
2014-09-03 09:14:16 +01:00
9fae76107f
fix rst
2014-09-03 04:30:51 +01:00
2b9afa775e
more critique
2014-09-02 23:50:40 +01:00
70aa4b9231
Edited room creation section to mention all the events created when the room is.
2014-09-02 21:45:36 +01:00
0aacab43ca
Added Qs which should be answered in the marked TODOs
2014-09-02 21:17:47 +01:00
dcbdfcc9d2
only need one voip section :)
2014-09-02 21:16:59 +01:00
7819a1010c
general documentation review and editing
2014-09-02 21:15:03 +01:00
ab6e1abe9c
Added the new power level related events which were recently introduced.
2014-09-02 21:12:46 +01:00
707cd32b13
Added more room alias bullet points.
2014-09-02 20:38:25 +01:00
2f5182b2d2
Finished up Identity section in the architecture section.
2014-09-02 20:32:09 +01:00
3167d47882
Minor formatting tweaks.
2014-09-02 17:58:16 +01:00
9f94b11d4c
Added section on rate limiting.
2014-09-02 17:51:45 +01:00
b175179e47
ALL THE LINKS! Most APIs now link to relative paths off the doc, outlined at the bottom of the .rst.
2014-09-02 17:34:24 +01:00
1952a1c68d
More formatting, more TODOs. Settled on a way of linking to external API docs; started converting references to relative links.
2014-09-02 17:05:30 +01:00
9613d65756
spec: Added internal links to different sections. Added NOTE and WARNING admonitions and hide away loooong TODO lists behind comments. Smaller ones remain.
2014-09-02 16:38:21 +01:00
b4984d5e15
Updated howto.rst to use the new APIs. Updated JSFiddles to use 8008. Linked new fiddles with howto.rst. Added more explanations.
2014-09-02 15:29:43 +01:00
4ac80b8570
Whoops: Put /events parameters object in the right part of the api tree.
2014-09-02 12:09:47 +01:00
5539251d82
Updated API docs with new keys on /createRoom and new API /rooms/$roomid/ban
2014-09-02 11:54:01 +01:00
fdcb876495
More ban spec. Added 'name' and 'topic' keys to /createRoom.
2014-09-02 11:46:53 +01:00
ab0637c2c3
Yet more bullet points on various sections.
2014-09-02 10:41:00 +01:00
15a7312273
Added section on banning users, currently in flux as the API changes / is implemented.
2014-09-02 09:34:28 +01:00
94bb4031f3
Expanded on bullet points in several sections.
2014-09-02 08:58:53 +01:00
74cffcf51a
Small formatting errors
2014-09-01 17:57:44 +01:00
6d07a28a29
fix lying docs
2014-09-01 17:55:41 +01:00
99ce820cc8
Little bit more on syncing APIs, need to know more about responses before more work can be done on it.
2014-09-01 17:51:31 +01:00
32bfd567ac
Added docs on presence 'last_active' field
2014-09-01 17:22:33 +01:00
5a11a8ef69
Flesh out Room Events.
2014-09-01 16:52:33 +01:00
401c16559d
Specced out state/non-state events. Start working on the myriad of syncing APIs.
2014-09-01 15:58:20 +01:00
02f4e3b3ff
Rename 'state' presence key to the much more obvious 'presence'; maintain a legacy 'state' copy for now
2014-09-01 14:45:41 +01:00
f500dd627a
Fleshed out joining/leaving rooms. Added M_LIMIT_EXCEEDED standard error code for rate limited requests.
2014-09-01 14:44:25 +01:00
389ee3624c
Added /web folder which contains html/css (based off the default swagger-ui) for viewing the c-s json api.
2014-09-01 14:11:26 +01:00
51b0b5c5ab
Renamed json files because: paths.
2014-09-01 14:05:28 +01:00
3bb93abb34
Start digging into invite/join/leave sections.
2014-09-01 10:38:48 +01:00
8fe912d95c
change the world: make the default matrix API URL prefix /_matrix rather than /matrix to make it easier for existing websites to mount a HS in their namespace without collisions.
...
perl -pi -e 's#/matrix#/_matrix#g' ./cmdclient/console.py ./docs/client-server/howto.rst ./docs/client-server/specification.rst ./docs/client-server/swagger_matrix/directory ./docs/client-server/swagger_matrix/events ./docs/client-server/swagger_matrix/login ./docs/client-server/swagger_matrix/presence ./docs/client-server/swagger_matrix/profile ./docs/client-server/swagger_matrix/registration ./docs/client-server/swagger_matrix/rooms ./docs/server-server/specification.rst ./graph/graph.py ./jsfiddles/create_room_send_msg/demo.js ./jsfiddles/event_stream/demo.js ./jsfiddles/example_app/demo.js ./jsfiddles/register_login/demo.js ./jsfiddles/room_memberships/demo.js ./synapse/api/urls.py ./tests/federation/test_federation.py ./tests/handlers/test_presence.py ./tests/handlers/test_typing.py ./tests/rest/test_events.py ./tests/rest/test_presence.py ./tests/rest/test_profile.py ./tests/rest/test_rooms.py ./webclient/components/fileUpload/file-upload-service.js ./webclient/components/matrix/matrix-service.js
2014-08-31 14:51:37 +01:00
74cc722b96
Added case-sensitivity notes on IDs, added TODO on UTF-8.
2014-08-29 17:45:09 +01:00
ca025c2b1d
Rooms: More subsections, more bullet points, more detail.
2014-08-29 16:50:41 +01:00
339dd3dc6c
Update API swagger JSON to default to POSTs not PUTs when describing the API.
2014-08-29 15:01:55 +01:00
898dde8812
Flesh out API standards.
2014-08-29 13:50:31 +01:00
ac56ac67cc
Expand architecture section to introduce room IDs, room aliases, user IDs, events and federation.
2014-08-29 11:42:05 +01:00
d1bf659ed7
Redo architecture diagram. Reword parts of federation. Formatting fixes and tweaks.
2014-08-29 10:30:14 +01:00
068b348e7e
Start fleshing out architecture section. Moar .rst formatting! Reword some copypastaed sections to be terser.
2014-08-28 17:40:12 +01:00
62dfa3c741
Flesh out m.room.message msgtypes
2014-08-28 15:35:28 +01:00
8d7d251c35
Support multiple login flows when deciding how to login. Updated cmdclient and spec. Webclient doesn't need updating for this.
2014-08-28 14:56:55 +01:00
52cfdfd5f1
Fleshed out login spec.
2014-08-28 14:49:21 +01:00
64e927108b
Added skeleton specification for a general feel of the layout.
2014-08-28 11:35:24 +01:00
660129deb1
Shuffle files around in /docs
2014-08-28 09:45:05 +01:00
6ad9d9c226
Added /rooms/$roomid/state and /rooms/$roomid/initialSync to API docs.
2014-08-27 17:02:08 +01:00
e179ed1f60
Added generic state/non-state event sending to the API docs.
2014-08-27 16:16:40 +01:00
abe2035d85
api docs: Finished adding all C-S APIs. Added initialSync, publicRooms, membership changes (generic and RPCy) and directory paths.
2014-08-27 15:41:38 +01:00
71095f4e6e
Updated swagger JSON: cleaned up unused entries. Converted most paths to the new format.
2014-08-27 12:14:35 +01:00
6c609425ba
Removed urls.rst - The API docs / swagger JSON should be used as the canonical source for the REST API. Keeping urls.rst around is just an extra maintenance burden.
2014-08-27 12:14:35 +01:00
e3c6c9057b
Added initial swagger REST API spec.
2014-08-22 13:40:37 +01:00
5048f4a915
Added final jsfiddle: an example app demonstrating most of the c2s api.
2014-08-20 16:45:59 +01:00
f4839ea042
Add some static fiddles for now (will migrate to github paths eventually)
2014-08-19 17:48:49 +01:00
b796d4b9d0
Added registration/login jsfiddle, formatted so it can be loaded directly from jsfiddle. Requires jQuery 1.8.3
2014-08-19 16:39:42 +01:00
7e83a58c4d
Proofing
2014-08-19 14:38:34 +01:00
e636e8799e
More formatting, more clarity.
2014-08-19 14:25:03 +01:00
77f1cc7d6d
rst formatting, section heading intro blurbs.
2014-08-19 14:03:16 +01:00
8464009a66
Added top level TODO and a bit more info on storing the 'end' token.
2014-08-19 13:43:45 +01:00
185a68b473
Added a first cut for a 'how to' on the client-server API.
2014-08-19 12:31:17 +01:00
1731781145
Document that /rooms/:room_id/members/list yields profile and presence information about room members
2014-08-15 17:24:02 +01:00
0b179db36d
s/Synapse/Matrix/
2014-08-14 18:58:40 +01:00
7a025d6368
It's called Matrix :)
2014-08-14 18:58:01 +01:00
94eb2560f4
Add documentation about Federation Queries and EDUs
2014-08-14 17:50:55 +01:00
30da8c81c7
webclient: You can now paginate in rooms. Defaults to 10 messages, with a button to get more (needs to be hooked into infini-scrolling).
2014-08-14 17:23:47 +01:00
61933f8e52
Added M_UNKNOWN_TOKEN error code and send it when there is an unrecognised access_token
2014-08-14 13:47:39 +01:00
59dfbaba3b
when we're talking about backfilling data in federation, call it backfilling - not pagination.
2014-08-13 18:17:09 +01:00
b80b32d1c0
pagination was a terrible name
2014-08-13 18:17:08 +01:00
820ed34abe
Namespace all the Federation HTTP URLs to /matrix/federation/v1/...
2014-08-13 15:07:55 +01:00
cf45ed1bc0
Add .rst suffix to documentation files so that github auto-formats them
2014-08-12 16:39:35 +01:00
4f475c7697
Reference Matrix Home Server
2014-08-12 15:10:52 +01:00
Erik Johnston