Skip to content

fix(user): teams are managed in the Teams app, not embedded in Contacts - #15590

Open
miaulalala wants to merge 1 commit into
masterfrom
fix/teams-app-not-embedded-in-contacts
Open

fix(user): teams are managed in the Teams app, not embedded in Contacts#15590
miaulalala wants to merge 1 commit into
masterfrom
fix/teams-app-not-embedded-in-contacts

Conversation

@miaulalala

Copy link
Copy Markdown
Contributor

The problem

The user manual describes Teams as "a feature embedded in the Contacts app". That is no longer where users find it, so the one place in the manuals that explains what a Team is points at the wrong app.

What actually happens now

  • The circles app declares <name>Teams</name> and registers its own navigation entry from code rather than info.xml, gated on the frontend_enabled app setting (default on), so it stays in sync with its PageController and dashboard widget.
  • Contacts only manages teams when that interface is disabled — its team routes are conditional on the isTeamManagementEnabled initial state, because the team views depend on the circles store module being registered.

So the two are deliberately mutually exclusive, and "embedded in Contacts" is now the fallback case rather than the default.

This change

  • Drops the "embedded in the Contacts app" claim from the Teams section.
  • Adds a note saying teams are managed in the Teams app, and that the Contacts team views described below apply on servers where the Teams interface is disabled.
  • Leaves the rest of the section (roles, membership, sharing) untouched, since it is still accurate wherever the views are rendered.

Follow-ups, deliberately not in this PR

  • The screenshot is stale (images/circle.png, alt text "Teams in the Contacts app left menu") and needs retaking in the Teams app.
  • Neither Teams nor Team folders has a page of its own. "Team folder" appears 19 times across the manuals, always in passing — activity configuration, encryption, primary storage, trashbin, automated tagging — and is never defined. The Teams API (ITeamManager, ITeamResourceProvider, ITeamFolderProvider) is undocumented for app developers even though Files, Talk and Deck implement it. Those pages are worth their own PRs.

@miaulalala

Copy link
Copy Markdown
Contributor Author

/backport to stable35

The Teams interface was extracted from Contacts again: the circles app
registers its own navigation entry (gated on the frontend_enabled app
setting) and ships its own frontend, while Contacts now only exposes
team management when that interface is disabled, via the
isTeamManagementEnabled initial state.

The user manual still described Teams as "a feature embedded in the
Contacts app", which sends readers to the wrong place.

Assisted-by: AGENT:claude-opus-5[1m]
Signed-off-by: Anna Larch <anna@nextcloud.com>
@miaulalala
miaulalala force-pushed the fix/teams-app-not-embedded-in-contacts branch from a134217 to 056186d Compare September 8, 2026 16:56
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Tue, 08 Sep 2026 17:19:44 GMT

@hamza221 hamza221 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Please don't backport to versions <=34
nextcloud/contacts#5669

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants