add a note about project search API

Gauvain Pocentek · Gauvain Pocentek · commit e48e4aca9650 · 2016-03-12T11:06:04.000+01:00
diff --git a/gitlab/objects.py b/gitlab/objects.py
@@ -1516,6 +1516,16 @@ class ProjectManager(BaseManager):
     def search(self, query, **kwargs):
         """Search projects by name.
 
+        .. note::
+
+           The search is only performed on the project name (not on the
+           namespace or the description). To perform a smarter search, use the
+           ``search`` argument of the ``list()`` method:
+
+           .. code-block:: python
+
+               gl.projects.list(search=your_search_string)
+
         Args:
             query (str): The query string to send to GitLab for the search.
             all (bool): If True, return all the items, without pagination
