{"action":"created","comment":{"url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/comments/188462867","pull_request_review_id":120446694,"id":188462867,"diff_hunk":"@@ -0,0 +1,172 @@\n+.. contents:: Table of Contents\n+.. sectnum::\n+\n+Proposals for Spec Changes to Matrix\n+------------------------------------\n+\n+The process for submitting a Matrix Spec Change (MSC) Proposal is as follows:\n+\n+- produce a publicly-accessible proposal describing your change:\n+\n+  - Please use Google Docs, or an equivalent system capable of collaborative\n+    editing, with versioned history, suggestions ('track changes'), threaded\n+    comments, and good mobile support.  Please ensure the document is\n+    world-commentable or -editable.\n+  - We do not use Github issues (or Etherpad) for the design process of the\n+    proposal, as the document review/commenting capabilities aren't good\n+    enough.\n+  - We also don't jump straight to PRing against the spec itself, as it's much\n+    faster to iterate on a proposal in freeform document form than in the\n+    terse and formal structure of the spec.\n+  - In the proposal, please clearly state the problem being solved, and the\n+    possible solutions being proposed for solving it and their respective\n+    trade-offs.\n+  - Proposal documents are intended to be as lightweight and flexible as the \n+    author desires; there is no formal template; the intention is to iterate\n+    as quickly as possible to get to a good design.\n+\n+- make a new issue at https://github.com/matrix-org/matrix-doc/issues (or\n+  modify an existing one), whose description should list the metadata as per\n+  below.\n+- Gather feedback as widely as possible from the community and core team on\n+  the proposal.\n+\n+  - The aim is to get maximum consensus on the trade-offs chosen to get an\n+    optimal solution.\n+  - A good place to ask for feedback on a specific proposal is\n+    `#matrix-spec:matrix.org <https://matrix.to/#/#matrix-spec:matrix.org>`_.\n+    However, authors/shepherds are welcome to use an alternative room if they\n+    prefer - please advertise it in #matrix-spec:matrix.org though and link\n+    to it on the github issue.  N.B. that #matrix-dev:matrix.org is for\n+    developers using existing Matrix APIs, #matrix:matrix.org is for users\n+    trying to run matrix apps (clients & servers);\n+    #matrix-architecture:matrix.org is for cross-cutting discussion of\n+    Matrix's architectural design.\n+  - Iterating on the proposal and gathering consensus can sometimes be\n+    time-consuming; an impartial 'shepherd' can be assigned to help guide the\n+    proposal through this process.\n+  \n+- Once the proposal has sufficient consensus and passed review, you **must**\n+  show an implementation to prove that it works well in practice, before a\n+  spec PR will be accepted.  Iterate on the proposal if needed.\n+- Finally, please make a new spec PR which includes the changes as\n+  implemented against\n+  https://github.com/matrix-org/matrix-doc/tree/master/specification.  This\n+  will then be reviewed and hopefully merged!  Please sign off the spec PR as\n+  per the `CONTRIBUTING.rst\n+  <https://github.com/matrix-org/matrix-doc/blob/master/CONTRIBUTING.rst>`_\n+  guidelines.\n+\n+Final decisions on review are made by the Matrix core team\n+(+matrix:matrix.org), acting on behalf of the whole Matrix community.\n+\n+Proposals **must** act to the greater benefit of the entire Matrix ecosystem,\n+rather than benefiting or privileging any single player or subset of players","path":"specification/proposals_intro.rst","position":64,"original_position":64,"commit_id":"84524df7830faadca24d9d8462ce03216467afc8","original_commit_id":"84524df7830faadca24d9d8462ce03216467afc8","user":{"login":"ara4n","id":1294269,"avatar_url":"https://avatars2.githubusercontent.com/u/1294269?v=4","gravatar_id":"","url":"https://api.github.com/users/ara4n","html_url":"https://github.com/ara4n","followers_url":"https://api.github.com/users/ara4n/followers","following_url":"https://api.github.com/users/ara4n/following{/other_user}","gists_url":"https://api.github.com/users/ara4n/gists{/gist_id}","starred_url":"https://api.github.com/users/ara4n/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ara4n/subscriptions","organizations_url":"https://api.github.com/users/ara4n/orgs","repos_url":"https://api.github.com/users/ara4n/repos","events_url":"https://api.github.com/users/ara4n/events{/privacy}","received_events_url":"https://api.github.com/users/ara4n/received_events","type":"User","site_admin":false},"body":"^ This, and from a game theoretic perspective we are incentivised to make Matrix as successful as possible for all participants, in order to maximise its network effects and make it most useful and valuable for any given stakeholder.  Given this is the whole point and promise of Matrix, we would be idiots to do anything to jeopardise the network for our own selfish benefit.","created_at":"2018-05-15T23:10:03Z","updated_at":"2018-05-15T23:10:04Z","html_url":"https://github.com/matrix-org/matrix-doc/pull/1240#discussion_r188462867","pull_request_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/comments/188462867"},"html":{"href":"https://github.com/matrix-org/matrix-doc/pull/1240#discussion_r188462867"},"pull_request":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240"}},"in_reply_to_id":188429741},"pull_request":{"url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240","id":188134675,"html_url":"https://github.com/matrix-org/matrix-doc/pull/1240","diff_url":"https://github.com/matrix-org/matrix-doc/pull/1240.diff","patch_url":"https://github.com/matrix-org/matrix-doc/pull/1240.patch","issue_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/1240","number":1240,"state":"open","locked":false,"title":"Spec Proposals page on matrix.org","user":{"login":"benparsons","id":1197991,"avatar_url":"https://avatars0.githubusercontent.com/u/1197991?v=4","gravatar_id":"","url":"https://api.github.com/users/benparsons","html_url":"https://github.com/benparsons","followers_url":"https://api.github.com/users/benparsons/followers","following_url":"https://api.github.com/users/benparsons/following{/other_user}","gists_url":"https://api.github.com/users/benparsons/gists{/gist_id}","starred_url":"https://api.github.com/users/benparsons/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/benparsons/subscriptions","organizations_url":"https://api.github.com/users/benparsons/orgs","repos_url":"https://api.github.com/users/benparsons/repos","events_url":"https://api.github.com/users/benparsons/events{/privacy}","received_events_url":"https://api.github.com/users/benparsons/received_events","type":"User","site_admin":false},"body":"An implementation/spec-PR of the very rough proposal at https://github.com/matrix-org/matrix-doc/issues/1233","created_at":"2018-05-15T13:48:18Z","updated_at":"2018-05-15T23:10:04Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9dc541cc41312e5835ab606950e83db455b8d498","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240/commits","review_comments_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240/comments","review_comment_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/comments{/number}","comments_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/1240/comments","statuses_url":"https://api.github.com/repos/matrix-org/matrix-doc/statuses/84524df7830faadca24d9d8462ce03216467afc8","head":{"label":"matrix-org:proposals","ref":"proposals","sha":"84524df7830faadca24d9d8462ce03216467afc8","user":{"login":"matrix-org","id":8418310,"avatar_url":"https://avatars2.githubusercontent.com/u/8418310?v=4","gravatar_id":"","url":"https://api.github.com/users/matrix-org","html_url":"https://github.com/matrix-org","followers_url":"https://api.github.com/users/matrix-org/followers","following_url":"https://api.github.com/users/matrix-org/following{/other_user}","gists_url":"https://api.github.com/users/matrix-org/gists{/gist_id}","starred_url":"https://api.github.com/users/matrix-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matrix-org/subscriptions","organizations_url":"https://api.github.com/users/matrix-org/orgs","repos_url":"https://api.github.com/users/matrix-org/repos","events_url":"https://api.github.com/users/matrix-org/events{/privacy}","received_events_url":"https://api.github.com/users/matrix-org/received_events","type":"Organization","site_admin":false},"repo":{"id":24998719,"name":"matrix-doc","full_name":"matrix-org/matrix-doc","owner":{"login":"matrix-org","id":8418310,"avatar_url":"https://avatars2.githubusercontent.com/u/8418310?v=4","gravatar_id":"","url":"https://api.github.com/users/matrix-org","html_url":"https://github.com/matrix-org","followers_url":"https://api.github.com/users/matrix-org/followers","following_url":"https://api.github.com/users/matrix-org/following{/other_user}","gists_url":"https://api.github.com/users/matrix-org/gists{/gist_id}","starred_url":"https://api.github.com/users/matrix-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matrix-org/subscriptions","organizations_url":"https://api.github.com/users/matrix-org/orgs","repos_url":"https://api.github.com/users/matrix-org/repos","events_url":"https://api.github.com/users/matrix-org/events{/privacy}","received_events_url":"https://api.github.com/users/matrix-org/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/matrix-org/matrix-doc","description":"Matrix Documentation (including The Spec)","fork":false,"url":"https://api.github.com/repos/matrix-org/matrix-doc","forks_url":"https://api.github.com/repos/matrix-org/matrix-doc/forks","keys_url":"https://api.github.com/repos/matrix-org/matrix-doc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/matrix-org/matrix-doc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/matrix-org/matrix-doc/teams","hooks_url":"https://api.github.com/repos/matrix-org/matrix-doc/hooks","issue_events_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/events{/number}","events_url":"https://api.github.com/repos/matrix-org/matrix-doc/events","assignees_url":"https://api.github.com/repos/matrix-org/matrix-doc/assignees{/user}","branches_url":"https://api.github.com/repos/matrix-org/matrix-doc/branches{/branch}","tags_url":"https://api.github.com/repos/matrix-org/matrix-doc/tags","blobs_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/refs{/sha}","trees_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/matrix-org/matrix-doc/statuses/{sha}","languages_url":"https://api.github.com/repos/matrix-org/matrix-doc/languages","stargazers_url":"https://api.github.com/repos/matrix-org/matrix-doc/stargazers","contributors_url":"https://api.github.com/repos/matrix-org/matrix-doc/contributors","subscribers_url":"https://api.github.com/repos/matrix-org/matrix-doc/subscribers","subscription_url":"https://api.github.com/repos/matrix-org/matrix-doc/subscription","commits_url":"https://api.github.com/repos/matrix-org/matrix-doc/commits{/sha}","git_commits_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/commits{/sha}","comments_url":"https://api.github.com/repos/matrix-org/matrix-doc/comments{/number}","issue_comment_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/comments{/number}","contents_url":"https://api.github.com/repos/matrix-org/matrix-doc/contents/{+path}","compare_url":"https://api.github.com/repos/matrix-org/matrix-doc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/matrix-org/matrix-doc/merges","archive_url":"https://api.github.com/repos/matrix-org/matrix-doc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/matrix-org/matrix-doc/downloads","issues_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues{/number}","pulls_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls{/number}","milestones_url":"https://api.github.com/repos/matrix-org/matrix-doc/milestones{/number}","notifications_url":"https://api.github.com/repos/matrix-org/matrix-doc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/matrix-org/matrix-doc/labels{/name}","releases_url":"https://api.github.com/repos/matrix-org/matrix-doc/releases{/id}","deployments_url":"https://api.github.com/repos/matrix-org/matrix-doc/deployments","created_at":"2014-10-09T16:41:02Z","updated_at":"2018-05-15T11:04:32Z","pushed_at":"2018-05-15T16:38:40Z","git_url":"git://github.com/matrix-org/matrix-doc.git","ssh_url":"git@github.com:matrix-org/matrix-doc.git","clone_url":"https://github.com/matrix-org/matrix-doc.git","svn_url":"https://github.com/matrix-org/matrix-doc","homepage":null,"size":6974,"stargazers_count":142,"watchers_count":142,"language":"JavaScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":79,"mirror_url":null,"archived":false,"open_issues_count":460,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":79,"open_issues":460,"watchers":142,"default_branch":"master"}},"base":{"label":"matrix-org:master","ref":"master","sha":"5274e9c146abfe97bba030e8648a8863fe9307c8","user":{"login":"matrix-org","id":8418310,"avatar_url":"https://avatars2.githubusercontent.com/u/8418310?v=4","gravatar_id":"","url":"https://api.github.com/users/matrix-org","html_url":"https://github.com/matrix-org","followers_url":"https://api.github.com/users/matrix-org/followers","following_url":"https://api.github.com/users/matrix-org/following{/other_user}","gists_url":"https://api.github.com/users/matrix-org/gists{/gist_id}","starred_url":"https://api.github.com/users/matrix-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matrix-org/subscriptions","organizations_url":"https://api.github.com/users/matrix-org/orgs","repos_url":"https://api.github.com/users/matrix-org/repos","events_url":"https://api.github.com/users/matrix-org/events{/privacy}","received_events_url":"https://api.github.com/users/matrix-org/received_events","type":"Organization","site_admin":false},"repo":{"id":24998719,"name":"matrix-doc","full_name":"matrix-org/matrix-doc","owner":{"login":"matrix-org","id":8418310,"avatar_url":"https://avatars2.githubusercontent.com/u/8418310?v=4","gravatar_id":"","url":"https://api.github.com/users/matrix-org","html_url":"https://github.com/matrix-org","followers_url":"https://api.github.com/users/matrix-org/followers","following_url":"https://api.github.com/users/matrix-org/following{/other_user}","gists_url":"https://api.github.com/users/matrix-org/gists{/gist_id}","starred_url":"https://api.github.com/users/matrix-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matrix-org/subscriptions","organizations_url":"https://api.github.com/users/matrix-org/orgs","repos_url":"https://api.github.com/users/matrix-org/repos","events_url":"https://api.github.com/users/matrix-org/events{/privacy}","received_events_url":"https://api.github.com/users/matrix-org/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/matrix-org/matrix-doc","description":"Matrix Documentation (including The Spec)","fork":false,"url":"https://api.github.com/repos/matrix-org/matrix-doc","forks_url":"https://api.github.com/repos/matrix-org/matrix-doc/forks","keys_url":"https://api.github.com/repos/matrix-org/matrix-doc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/matrix-org/matrix-doc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/matrix-org/matrix-doc/teams","hooks_url":"https://api.github.com/repos/matrix-org/matrix-doc/hooks","issue_events_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/events{/number}","events_url":"https://api.github.com/repos/matrix-org/matrix-doc/events","assignees_url":"https://api.github.com/repos/matrix-org/matrix-doc/assignees{/user}","branches_url":"https://api.github.com/repos/matrix-org/matrix-doc/branches{/branch}","tags_url":"https://api.github.com/repos/matrix-org/matrix-doc/tags","blobs_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/refs{/sha}","trees_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/matrix-org/matrix-doc/statuses/{sha}","languages_url":"https://api.github.com/repos/matrix-org/matrix-doc/languages","stargazers_url":"https://api.github.com/repos/matrix-org/matrix-doc/stargazers","contributors_url":"https://api.github.com/repos/matrix-org/matrix-doc/contributors","subscribers_url":"https://api.github.com/repos/matrix-org/matrix-doc/subscribers","subscription_url":"https://api.github.com/repos/matrix-org/matrix-doc/subscription","commits_url":"https://api.github.com/repos/matrix-org/matrix-doc/commits{/sha}","git_commits_url":"https://api.github.com/repos/matrix-org/matrix-doc/git/commits{/sha}","comments_url":"https://api.github.com/repos/matrix-org/matrix-doc/comments{/number}","issue_comment_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/comments{/number}","contents_url":"https://api.github.com/repos/matrix-org/matrix-doc/contents/{+path}","compare_url":"https://api.github.com/repos/matrix-org/matrix-doc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/matrix-org/matrix-doc/merges","archive_url":"https://api.github.com/repos/matrix-org/matrix-doc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/matrix-org/matrix-doc/downloads","issues_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues{/number}","pulls_url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls{/number}","milestones_url":"https://api.github.com/repos/matrix-org/matrix-doc/milestones{/number}","notifications_url":"https://api.github.com/repos/matrix-org/matrix-doc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/matrix-org/matrix-doc/labels{/name}","releases_url":"https://api.github.com/repos/matrix-org/matrix-doc/releases{/id}","deployments_url":"https://api.github.com/repos/matrix-org/matrix-doc/deployments","created_at":"2014-10-09T16:41:02Z","updated_at":"2018-05-15T11:04:32Z","pushed_at":"2018-05-15T16:38:40Z","git_url":"git://github.com/matrix-org/matrix-doc.git","ssh_url":"git@github.com:matrix-org/matrix-doc.git","clone_url":"https://github.com/matrix-org/matrix-doc.git","svn_url":"https://github.com/matrix-org/matrix-doc","homepage":null,"size":6974,"stargazers_count":142,"watchers_count":142,"language":"JavaScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":79,"mirror_url":null,"archived":false,"open_issues_count":460,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":79,"open_issues":460,"watchers":142,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240"},"html":{"href":"https://github.com/matrix-org/matrix-doc/pull/1240"},"issue":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/issues/1240"},"comments":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/issues/1240/comments"},"review_comments":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240/comments"},"review_comment":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/1240/commits"},"statuses":{"href":"https://api.github.com/repos/matrix-org/matrix-doc/statuses/84524df7830faadca24d9d8462ce03216467afc8"}},"author_association":"NONE"}}
{"actor":{"display_login":"ara4n"}}