doc RPCs

Author: AlexTugarev

components/public-api/gitpod/v1/scm.proto

@@ -8,9 +8,17 @@ import "google/protobuf/timestamp.proto";
 option go_package = "github.com/gitpod-io/gitpod/components/public-api/go/v1";
 
 service SCMService {
+  // SearchSCMTokens allows clients to retrieve SCM tokens based on the
+  // specified host.
   rpc SearchSCMTokens(SearchSCMTokensRequest) returns (SearchSCMTokensResponse) {}
+  // GuessTokenScopes allows clients to retrieve scopes their SCM token would
+  // require for the specified git command.
   rpc GuessTokenScopes(GuessTokenScopesRequest) returns (GuessTokenScopesResponse) {}
+  // SearchRepositories allows clients to search for suggested repositories of
+  // SCM providers they are connected with.
   rpc SearchRepositories(SearchRepositoriesRequest) returns (SearchRepositoriesResponse) {}
+  // ListSuggestedRepositories allows clients to list suggested repositories
+  // based on recent workspaces and accessible repo configurations.
   rpc ListSuggestedRepositories(ListSuggestedRepositoriesRequest) returns (ListSuggestedRepositoriesResponse) {}
 }