From c61f8acce5189536ef6c7b69dbd26b391d85f9e6 Mon Sep 17 00:00:00 2001
From: Edwin Kempin <ekempin@google.com>
Date: Fri, 27 Dec 2019 13:59:05 +0100
Subject: [PATCH] Document GetCapabilities / GetCapabilities.CheckOne classes

Change-Id: If4ecb81915f14d3fb9a09bcc951c7dd809f2fea7
Signed-off-by: Edwin Kempin <ekempin@google.com>
---
 .../server/restapi/account/GetCapabilities.java       | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/java/com/google/gerrit/server/restapi/account/GetCapabilities.java b/java/com/google/gerrit/server/restapi/account/GetCapabilities.java
index fa9ab18bd2..f3d95572b2 100644
--- a/java/com/google/gerrit/server/restapi/account/GetCapabilities.java
+++ b/java/com/google/gerrit/server/restapi/account/GetCapabilities.java
@@ -49,6 +49,11 @@ import java.util.Map;
 import java.util.Set;
 import org.kohsuke.args4j.Option;
 
+/**
+ * REST endpoint to list the global capabilities that are assigned to an account.
+ *
+ * <p>This REST endpoint handles {@code GET /accounts/<account-identifier>/capabilities/} requests.
+ */
 public class GetCapabilities implements RestReadView<AccountResource> {
   @Option(name = "-q", metaVar = "CAP", usage = "Capability to inspect")
   void addQuery(String name) {
@@ -159,6 +164,12 @@ public class GetCapabilities implements RestReadView<AccountResource> {
     }
   }
 
+  /**
+   * REST endpoint to check if a global capability is assigned to an account.
+   *
+   * <p>This REST endpoint handles {@code GET
+   * /accounts/<account-identifier>/capabilities/<capability-identifier>} requests.
+   */
   @Singleton
   public static class CheckOne implements RestReadView<AccountResource.Capability> {
     private final PermissionBackend permissionBackend;