Skip to content

docs(admin): document Contacts organization chart setup - #15730

Open
whoalin1 wants to merge 2 commits into
nextcloud:masterfrom
whoalin1:docs/contacts-organization-chart
Open

whoalin1 wants to merge 2 commits into
nextcloud:masterfrom
whoalin1:docs/contacts-organization-chart

Conversation

@whoalin1

@whoalin1 whoalin1 commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Closes #12127

Document how the Contacts organization chart is populated from the system address book: line Manager on the user (Users admin), Organisation / Role profile fields with Local+ scope, and that only system address book accounts appear in the chart.

Test plan

  • Docs build for admin_manual/groupware/contacts.rst
  • Section links to system address book + user_configuration Manager docs
  • Notes Private scope exclusion and sync/occ rewrite

AI disclosure

This PR was drafted with the help of AI coding assistants (Cursor agents / LLM-based tools), including the description. I am responsible for it and happy to rework anything that doesn't fit.

All commits carry an Assisted-by: Cursor:grok-4.7 trailer.

Assisted-by: Cursor:grok-4.7
Signed-off-by: whoalin1 <whoalin414@gmail.com>
@whoalin1
whoalin1 force-pushed the docs/contacts-organization-chart branch from 8469f01 to f9c0c26 Compare October 9, 2026 14:10
Comment thread admin_manual/groupware/contacts.rst Outdated
Comment on lines +71 to +72
* After changing managers or profile fields, wait for the automatic sync or run
the :ref:`system address book sync<dav-sync-system-address-book>` occ command.

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.

System address book contacts are updated instantly

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Thanks, fixed in 880de3a: the prerequisites now say changes reach the system address book right away, and I dropped the "wait for sync / run occ" advice.

AI disclosure: drafted with help from an AI assistant.

Comment thread admin_manual/groupware/contacts.rst Outdated
**Manager** field to another local account. See :doc:`../configuration_user/user_configuration`.

Setting a manager does **not** grant admin rights. The value is written into the
user's system address book card (``X-MANAGERSNAME``) and is what the chart uses

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.

I don't think users need to know the property names of vcards

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Agreed. In 880de3a I removed the vCard property names (X-MANAGERSNAME, ORG, TITLE), so the section now only describes what users set and what the chart shows.

AI disclosure: drafted with help from an AI assistant.

@github-actions

Copy link
Copy Markdown
Contributor

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)

System address book updates are applied right away, and users do not
need the vCard property names.

Assisted-by: Cursor:grok-4.7
Signed-off-by: whoalin1 <whoalin414@gmail.com>

This branch has not been deployed

No deployments
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.

Add documentation for contacts organization chart

2 participants