nextcloud / nextcloud/documentation
macOS Client: Undocumented menu bar status (triangle with exclamation mark)
- Dominant language
- JavaScript
- Stars
- 628
- Forks
- 2.5k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 135
Description
Before You Submit
- I have checked for existing issues and pull requests related to my suggestion.
- I have posted on the Nextcloud Community Help Forum if my suggestion is a troubleshooting scenario or I'm unsure about the solution.
Type of Suggestion
Proposing new documentation content
Relevant Documentation Links
https://docs.nextcloud.com/server/latest/user_manual/en/desktop/usage.html
Summary
It seems the client uses a new status icon which is not explained
Details
My MacOS client (v 4.0.6) seems to use a new - presumably - warning icon in certain situations. This icon is shown in the top menu bar instead of the usual NextCloud icon:
Neither does hovering over the icon explain this (--> issue for the sync client), nor does the manual explain this.
Additional Notes
It seems that the icon is named "state-warning.svg" and the Code makes use of this when the status is either SyncResult::Undefined or SyncResult::Problem.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the desktop usage documentation at docs.nextcloud.com/server/latest/user_manual/en/desktop/usage.html and review the linked state-warning.svg reference in src/libsync/theme.cpp around line 700. Check linked pull request #15635 for the work already underway; the documentation is done when the macOS warning icon and its Undefined or Problem states are explained.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos
- Domain
- desktop, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100