Merge branch 'master' into travis/reporting

2018-05-31 10:57:33 -06:00 · 2018-05-31 10:57:33 -06:00 · 8610effad7
commit 8610effad7
parent 352f1b7776 f17195529b
7 changed files with 130 additions and 51 deletions
--- a/README.rst
+++ b/README.rst
@ -68,10 +68,10 @@ Windows users
 ~~~~~~~~~~~~~

 If you're on Windows Vista or higher, be sure that the "Symbolic Links"
-option was selected when installing Git prior to cloning this repository. If 
-you're still seeing errors about files not being found it is likely because 
-the symlink at ``api/client-server/definitions/event-schemas`` looks like a 
-file. To correct the problem, open an Administrative/Elevated shell in your 
+option was selected when installing Git prior to cloning this repository. If
+you're still seeing errors about files not being found it is likely because
+the symlink at ``api/client-server/definitions/event-schemas`` looks like a
+file. To correct the problem, open an Administrative/Elevated shell in your
 cloned matrix-doc directory and run the following::

  cd api\client-server\definitions
@ -121,7 +121,7 @@ changes.
 It is written in Go, so you will need the ``go`` compiler installed on your
 computer. You will also need to install fsnotify by running::

-  go get gopkg.in/fsnotify.v1
+  go get gopkg.in/fsnotify/fsnotify.v1

 Then, create a virtualenv as described above under `Preparation`_,
 and::
--- a/api/client-server/logout.yaml
+++ b/api/client-server/logout.yaml
@ -44,3 +44,26 @@ paths:
            properties: {}
      tags:
        - Session management
+  "/logout/all":
+    post:
+      summary: Invalidates all access tokens for a user
+      description: |-
+        Invalidates all access tokens for a user, so that they can no longer be used for
+        authorization. This includes the access token that made this request. 
+
+        This endpoint does not require UI authorization because UI authorization is
+        designed to protect against attacks where the someone gets hold of a single access
+        token then takes over the account. This endpoint invalidates all access tokens for
+        the user, including the token used in the request, and therefore the attacker is
+        unable to take over the account in this way.
+      operationId: logout_all
+      security:
+        - accessToken: []
+      responses:
+        200:
+          description: The user's access tokens were succesfully invalidated.
+          schema:
+            type: object
+            properties: {}
+      tags:
+        - Session management
--- a/changelogs/client_server.rst
+++ b/changelogs/client_server.rst
@ -50,6 +50,8 @@ Unreleased changes
    (`#1151 <https://github.com/matrix-org/matrix-doc/pull/1151>`_).
  - Add report content API
    (`#1264 <https://github.com/matrix-org/matrix-doc/pull/1264>`_).
+  - Document ``/logout/all`` endpoint
+    (`#1263 <https://github.com/matrix-org/matrix-doc/pull/1263>`_).

 r0.3.0
 ======
--- a/scripts/continuserv/README
+++ b/scripts/continuserv/README
@ -1,6 +0,0 @@
-continuserv proactively re-generates the spec on filesystem changes, and serves it over HTTP.
-
-To run it, you must install the `go` tool. You will also need to install fsnotify by running:
- `go get gopkg.in/fsnotify/fsnotify.v1`
-You can then run continuserv by running:
- `go run main.go`
--- a/scripts/continuserv/README.md
+++ b/scripts/continuserv/README.md
@ -0,0 +1,3 @@
+continuserv proactively re-generates the spec on filesystem changes, and serves
+it over HTTP. For notes on using it, see [the main
+readme](../../README.rst#continuserv).
--- a/scripts/proposals.py
+++ b/scripts/proposals.py
@ -22,7 +22,7 @@ def getpage(url, page):
 def getbylabel(label):
    pagecount = 1
    json = list()
-    urlbase = 'https://api.github.com/repos/matrix-org/matrix-doc/issues?state=open&labels=' + label + '&page='
+    urlbase = 'https://api.github.com/repos/matrix-org/matrix-doc/issues?state=all&labels=' + label + '&page='
    print(urlbase)
    json.extend(getpage(urlbase, 1))
    for page in range(2, int(pagecount) + 1):
@ -100,7 +100,7 @@ for label in labels:
        text_file.write("     - " + updated.strftime('%Y-%m-%d') + "\n")

        # list of document links (urls comma-separated)
-        maindoc = re.search('^Documentation: (.+?)\n', str(item['body']))
+        maindoc = re.search('^Documentation: (.+?)$', str(item['body']), flags=re.MULTILINE)
        if maindoc is not None:
            maindoc = maindoc.group(1)
            doc_list_formatted = ["`" + str(item['number']) + "-" + str(i) + " <" + x.strip() + ">`_" for i, x in enumerate(maindoc.split(','),1)]
--- a/specification/proposals.rst
+++ b/specification/proposals.rst
@ -68,7 +68,7 @@ proposal-wip
   * - `MSC1207 <https://github.com/matrix-org/matrix-doc/issues/1207>`_
     - Publishing Room Lists for 3rd party networks
     - 2016-10-21
-     - 2018-05-15
+     - 2018-05-31
     - `1207-1 <https://docs.google.com/document/d/12mVuOT7Qoa49L_PQAPjavoK9c2nalYEFOHxJOmH5j-w/edit>`_
     - `@erikjohnston`_
     - None
@ -140,7 +140,7 @@ proposal-wip
   * - `MSC1222 <https://github.com/matrix-org/matrix-doc/issues/1222>`_
     - Pushing updates about Groups (Communities) to clients
     - 2018-01-02
-     - 2018-05-15
+     - 2018-05-24
     - `1222-1 <https://drive.google.com/open?id=1GzwhGdnWWMENYOaXMFP8CD-M9ny1vznxHnNqT3I3NZI>`_
     - `@ara4n`_
     - None
@ -156,7 +156,7 @@ proposal-wip
   * - `MSC1227 <https://github.com/matrix-org/matrix-doc/issues/1227>`_
     - Proposal for lazy-loading room members to improve initial sync speed and client RAM usage
     - 2018-03-05
-     - 2018-05-15
+     - 2018-05-28
     - `1227-1 <https://docs.google.com/document/d/11yn-mAkYll10RJpN0mkYEVqraTbU3U4eQx9MNrzqX1U/edit>`_
     - `@ara4n`_
     - None
@ -185,6 +185,14 @@ proposal-wip
     - `@neilisfragile`_
     - None
     - 
+   * - `MSC1267 <https://github.com/matrix-org/matrix-doc/issues/1267>`_
+     - Interactive Key Verification
+     - 2018-05-28
+     - 2018-05-28
+     - `1267-1 <https://docs.google.com/document/d/1SXmyjyNqClJ5bTHtwvp8tT1Db4pjlGVxfPQNdlQILqU/edit#>`_
+     - `@uhoreg`_
+     - None
+     - 



@ -204,14 +212,6 @@ proposal-ready-for-review
     - Author
     - Shepherd
     - PRs
-   * - `MSC1183 <https://github.com/matrix-org/matrix-doc/issues/1183>`_
-     - Document key-share requests
-     - 2018-04-30
-     - 2018-05-15
-     - `1183-1 <https://docs.google.com/document/d/1m4gQkcnJkxNuBmb5NoFCIadIY-DyqqNAS3lloE73BlQ>`_
-     - `@richvdh`_
-     - None
-     - 
   * - `MSC1232 <https://github.com/matrix-org/matrix-doc/issues/1232>`_
     - Media limits API
     - 2018-05-04
@ -228,6 +228,14 @@ proposal-ready-for-review
     - `@turt2live`_
     - None
     - 
+   * - `MSC1270 <https://github.com/matrix-org/matrix-doc/issues/1270>`_
+     - Synapse /_matrix/media/v1/resolve_url to API download and preview urls in the clients despite on CORS
+     - 2018-05-31
+     - 2018-05-31
+     - `1270-1 <https://docs.google.com/document/d/1bbX1yxNETmMa-AxBGjIpb4lNoTuc3vjGXmbZWrNBlzM/edit?usp=sharing>`_
+     - `@oivoodoo`_
+     - None
+     - 



@ -325,6 +333,14 @@ spec-pr-missing
     - Author
     - Shepherd
     - PRs
+   * - `MSC1200 <https://github.com/matrix-org/matrix-doc/issues/1200>`_
+     - Configuration of E2E encryption in a room
+     - 2016-06-16
+     - 2018-05-31
+     - `1200-1 <https://docs.google.com/document/d/1SEPMhNh6ztcrrbkGRSayVQ23bd3cfMPkTgGL4kBS9Ps/edit#heading=h.e7hfigo2zcsj>`_
+     - `@richvdh`_
+     - None
+     - 
   * - `MSC1201 <https://github.com/matrix-org/matrix-doc/issues/1201>`_
     - Device Management API
     - 2016-07-14
@ -421,14 +437,22 @@ spec-pr-missing
     - `@lukebarnard1`_
     - None
     - 
-   * - `MSC1216 <https://github.com/matrix-org/matrix-doc/issues/1216>`_
-     - @room notification proposal
+   * - `MSC1033 <https://github.com/matrix-org/matrix-doc/issues/1033>`_
+     - Doc @room notifications
     - 2017-10-23
-     - 2018-05-15
-     - `1216-1 <https://docs.google.com/document/d/1qRdlg94cr9YXxPCwhW4HgI2oDrqQOUKX5HptZFBGf6o/edit>`_
+     - 2018-05-31
+     - 
     - `@dbkr`_
     - None
-     - `PR#1176`_
+     - 
+   * - `MSC1183 <https://github.com/matrix-org/matrix-doc/issues/1183>`_
+     - Document key-share requests
+     - 2018-04-30
+     - 2018-05-31
+     - `1183-1 <https://docs.google.com/document/d/1m4gQkcnJkxNuBmb5NoFCIadIY-DyqqNAS3lloE73BlQ>`_
+     - `@richvdh`_
+     - None
+     - 
   * - `MSC1230 <https://github.com/matrix-org/matrix-doc/issues/1230>`_
     - Temporary mitigation for depth parameter abuse
     - 2018-05-01
@ -464,6 +488,14 @@ merged
     - Author
     - Shepherd
     - PRs
+   * - `MSC1197 <https://github.com/matrix-org/matrix-doc/issues/1197>`_
+     - Ignoring Users
+     - 2016-05-03
+     - 2018-05-18
+     - `1197-1 <https://docs.google.com/document/d/1Jex7lDAwmv0KcgyL9oeGfUCsjw0CWSqedPKZ1ViSVis/edit>`_
+     - `@erikjohnston`_
+     - None
+     - `PR#1142`_
   * - `MSC1199 <https://github.com/matrix-org/matrix-doc/issues/1199>`_
     - Notifications API
     - 2016-05-23
@ -472,14 +504,6 @@ merged
     - `@dbkr`_
     - None
     - 
-   * - `MSC1200 <https://github.com/matrix-org/matrix-doc/issues/1200>`_
-     - Configuration of E2E encryption in a room
-     - 2016-06-16
-     - 2018-05-15
-     - `1200-1 <https://docs.google.com/document/d/1SEPMhNh6ztcrrbkGRSayVQ23bd3cfMPkTgGL4kBS9Ps/edit#heading=h.e7hfigo2zcsj>`_
-     - `@richvdh`_
-     - None
-     - 
   * - `MSC1204 <https://github.com/matrix-org/matrix-doc/issues/1204>`_
     - Access Token Semantics (refresh and macaroons) - aka Auth Sept 2016 Edition
     - 2016-09-29
@ -488,6 +512,14 @@ merged
     - `@richvdh`_
     - None
     - 
+   * - `MSC953 <https://github.com/matrix-org/matrix-doc/issues/953>`_
+     - Add /user_directory/search API
+     - 2017-05-31
+     - 2018-05-10
+     - `953-1 <https://docs.google.com/document/d/1Xc9lAM-FiIC66Z5pnaI4D5zqAqcFcZ5uHr3bYT-DWVk/edit>`_
+     - `@erikjohnston`_
+     - None
+     - 
   * - `MSC1233 <https://github.com/matrix-org/matrix-doc/issues/1233>`_
     - A proposal for organising spec proposals
     - 2018-05-10
@ -566,6 +598,22 @@ obsolete
     - Author
     - Shepherd
     - PRs
+   * - `MSC1223 <https://github.com/matrix-org/matrix-doc/issues/1223>`_
+     - Replies event format
+     - 2018-02-01
+     - 2018-05-15
+     - `1223-1 <https://docs.google.com/document/d/1KLdKtuZBbFoWDSfN4KM3p7LnIvFBQfSORICBo8zRHaE/edit>`_
+     - `@t3chguy`_
+     - None
+     - 
+   * - `MSC1224 <https://github.com/matrix-org/matrix-doc/issues/1224>`_
+     - Replies - next steps
+     - 2018-02-03
+     - 2018-05-15
+     - `1224-1 <https://docs.google.com/document/d/1FZsvodn2C0iKJDtn-8y8IPwOa96ixoJejK3gMLVOXHM/edit>`_
+     - `@t3chguy`_
+     - None
+     - 
   * - `MSC1235 <https://github.com/matrix-org/matrix-doc/issues/1235>`_
     - Proposal for Calendar Events
     - 2018-02-06
@ -574,34 +622,43 @@ obsolete
     - `@Half-Shot`_
     - None
     - 
+   * - `MSC1220 <https://github.com/matrix-org/matrix-doc/issues/1220>`_
+     - Rich quoting proposal
+     - 2018-05-10
+     - 2018-05-15
+     - `1220-1 <https://docs.google.com/document/d/146zJr4h6odczMeGUH99dxDZk0i_iVtDiVMy510G25jI/edit>`_
+     - `@t3chguy`_
+     - None
+     - 





+.. _@rxl881: https://github.com/rxl881
+.. _@psaavedra: https://github.com/psaavedra
+.. _@erikjohnston: https://github.com/erikjohnston
 .. _@t3chguy: https://github.com/t3chguy
+.. _@Kegsay: https://github.com/Kegsay
 .. _@KitsuneRal: https://github.com/KitsuneRal
-.. _@pik: https://github.com/pik
 .. _@leonerd: https://github.com/leonerd
 .. _@turt2live: https://github.com/turt2live
-.. _@erikjohnston: https://github.com/erikjohnston
-.. _@neilisfragile: https://github.com/neilisfragile
-.. _@psaavedra: https://github.com/psaavedra
-.. _@richvdh: https://github.com/richvdh
-.. _@NegativeMjark: https://github.com/NegativeMjark
 .. _@ara4n: https://github.com/ara4n
-.. _@lukebarnard1: https://github.com/lukebarnard1
-.. _@lampholder: https://github.com/lampholder
-.. _@dbkr: https://github.com/dbkr
 .. _@maxidor: https://github.com/maxidor
-.. _others: https://github.com/thers
-.. _@rxl881: https://github.com/rxl881
 .. _@uhoreg: https://github.com/uhoreg
-.. _@Kegsay: https://github.com/Kegsay
+.. _@pik: https://github.com/pik
+.. _@neilisfragile: https://github.com/neilisfragile
+.. _@lukebarnard1: https://github.com/lukebarnard1
+.. _others: https://github.com/thers
 .. _@Half-Shot: https://github.com/Half-Shot
 .. _@aviraldg: https://github.com/aviraldg
+.. _@oivoodoo: https://github.com/oivoodoo
+.. _@richvdh: https://github.com/richvdh
+.. _@NegativeMjark: https://github.com/NegativeMjark
+.. _@lampholder: https://github.com/lampholder
+.. _@dbkr: https://github.com/dbkr
 .. _PR#310: https://github.com/matrix-org/matrix-doc/pull/310
+.. _PR#1142: https://github.com/matrix-org/matrix-doc/pull/1142
 .. _PR#1240: https://github.com/matrix-org/matrix-doc/pull/1240
 .. _PR#1189: https://github.com/matrix-org/matrix-doc/pull/1189
-.. _PR#919: https://github.com/matrix-org/matrix-doc/pull/919
-.. _PR#1176: https://github.com/matrix-org/matrix-doc/pull/1176
+.. _PR#919: https://github.com/matrix-org/matrix-doc/pull/919