From d008575bf9909cf1c563d5ac98c17c49f893cc56 Mon Sep 17 00:00:00 2001 From: David Pursehouse Date: Fri, 21 Dec 2018 00:43:19 +0900 Subject: [PATCH] dev-design: Remove section about JSON-RPC This section is no longer relevant after the removal of GWT and removal of RPC services. Change-Id: I43ed3e8419b51c40488bab34b598cceb63e26c16 --- Documentation/dev-design.txt | 28 ---------------------------- 1 file changed, 28 deletions(-) diff --git a/Documentation/dev-design.txt b/Documentation/dev-design.txt index d2fd958cc2..69af18d3a6 100644 --- a/Documentation/dev-design.txt +++ b/Documentation/dev-design.txt @@ -302,34 +302,6 @@ they choose. Gerrit does not integrate with any Google service, or any other services other than those listed above. - -== Standards / Developer APIs - -Gerrit uses an XSRF protected variant of JSON-RPC 1.1 to communicate -between the browser client and the server. - -As the protocol is not the proprietry protocol, but is instead a -self-describing standard JSON format it is easily implemented by -any 3rd party client application, provided the client has a JSON -parser and HTTP client library available. - -As the entire command set necessary for the standard web browser -based UI is exposed through JSON-RPC over HTTP, there are no other -data feeds or command interfaces to the server. - -Commands requiring user authentication may require the user agent to -complete a sign-in cycle through the user's OpenID provider in order -to establish the HTTP cookie Gerrit uses to track user identity. -Automating this sign-in process for non-web browser agents is -outside of the scope of Gerrit, as each OpenID provider uses its own -sign-in sequence. Use of OpenID providers which have difficult to -automate interfaces may make it impossible for non-browser agents -to be used with the JSON-RPC interface. - -* link:http://json-rpc.org/wd/JSON-RPC-1-1-WD-20060807.html[JSON-RPC 1.1] -* link:https://gerrit.googlesource.com/gwtjsonrpc/+/master/README[XSRF JSON-RPC] - - == Privacy Considerations Gerrit stores the following information per user account: