From ab5ae3d8957fa62f39608c574d435bc2c39fdf00 Mon Sep 17 00:00:00 2001
From: Teryk Bellahsene <teryk.bellahsene@sonarsource.com>
Date: Thu, 28 Jan 2016 10:04:34 +0100
Subject: [PATCH] SONAR-6584 WS api/resources/index document known bug
 regarding pagination

---
 .../java/org/sonar/server/component/ws/ResourcesWs.java  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/server/sonar-server/src/main/java/org/sonar/server/component/ws/ResourcesWs.java b/server/sonar-server/src/main/java/org/sonar/server/component/ws/ResourcesWs.java
index f2ea2507ed2..618cc39a526 100644
--- a/server/sonar-server/src/main/java/org/sonar/server/component/ws/ResourcesWs.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/component/ws/ResourcesWs.java
@@ -41,7 +41,14 @@ public class ResourcesWs implements WebService {
 
   private void defineIndexAction(NewController controller) {
     NewAction action = controller.createAction("index")
-      .setDescription("Get a list of components. Requires Browse permission on resource")
+      .setDescription("Gets a list of components. Requires Browse permission on resource.<br>" +
+        "The web service is deprecated and you're invited to use the alternatives: " +
+        "<ul>" +
+        "<li>if you need components only: api/components/tree</li>" +
+        "<li>if you need components with measures: api/measures/component_tree</li>" +
+        "</ul>" +
+        "When you provide one metric, the number of results is limited to 500. When several metrics are provided, the number of results is not limited. " +
+        "This is a known limitation and it won't be fixed.")
       .setSince("2.10")
       .setDeprecatedSince("5.4")
       .setHandler(RailsHandler.INSTANCE)
-- 
2.39.5