list_groups() documentation unclear, as is the REST API related to it.

In this section:

• https://github.com/microsoft/azure-devops-python-api/blob/dev/azure-devops/azure/devops/v5_1/graph/graph_client.py#L145-L152

which has this blob of code:

    def list_groups(self, scope_descriptor=None, subject_types=None, continuation_token=None):
        """ListGroups.
        [Preview API] Gets a list of all groups in the current scope (usually organization or account).
        :param str scope_descriptor: Specify a non-default scope (collection, project) to search for groups.
        :param [str] subject_types: A comma separated list of user subject subtypes to reduce the retrieved results, e.g. Microsoft.IdentityModel.Claims.ClaimsIdentity
        :param str continuation_token: An opaque data blob that allows the next page of data to resume immediately after where the previous page ended. The only reliable way to know if there is more data left is the presence of a continuation token.
        :rtype: :class:`<PagedGraphGroups> <azure.devops.v5_1.graph.models.PagedGraphGroups>`
        """

what is actually meant by these pieces and where should I find that information? The REST API docs dont' really tell much and aren't much help either.

• https://docs.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list

Commencez par azure-devops/azure/devops/v5_1/graph/graph_client.py autour des lignes 145-152 et comparez la docstring de list_groups avec la documentation REST Azure DevOps Graph Groups liée. Déterminez ce que signifie chaque paramètre ainsi que la valeur PagedGraphGroups renvoyée, puis mettez à jour la documentation concernée afin que les utilisateurs puissent trouver des explications et des références claires.