Skip to content

docs(group): clarify group listing API docs#60193

Open
joshtrichards wants to merge 3 commits intomasterfrom
jtr/docs-getGroups-contract
Open

docs(group): clarify group listing API docs#60193
joshtrichards wants to merge 3 commits intomasterfrom
jtr/docs-getGroups-contract

Conversation

@joshtrichards
Copy link
Copy Markdown
Member

Summary

Clarifies the public GroupInterface::getGroups() documentation to describe search/pagination behavior more accurately, and removes/trims redundant implementation docblocks in private group backends.

Arose while looking at nextcloud/guests#1465, where I discovered its implementation doesn't even use the $search criteria currently (fixing that there now separately).

Checklist

AI (if applicable)

  • The content of this PR was partly or fully generated using AI

Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
No need to repeat public API bits

Signed-off-by: Josh <josh.t.richards@gmail.com>
@joshtrichards joshtrichards added this to the Nextcloud 34 milestone May 6, 2026
@joshtrichards joshtrichards requested a review from a team as a code owner May 6, 2026 16:11
@joshtrichards joshtrichards added 3. to review Waiting for reviews technical debt 🧱 🤔🚀 labels May 6, 2026
@joshtrichards joshtrichards requested review from ArtificialOwl and removed request for a team May 6, 2026 16:11
$ldap_groups = $this->access->nextcloudGroupNames($ldap_groups);

$this->access->connection->writeToCache($cacheKey, $ldap_groups);
return $ldap_groups;
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
return array_values($ldap_groups);

@CarlSchwan CarlSchwan requested a review from come-nc May 7, 2026 09:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants