fix(groupware): Move admin and user documentation for mail app out of mail repo and update debug logging #13993
Conversation
DerDreschner
requested review from
ChristophWurst,
GretaD and
kesselb
as code owners
DerDreschner
force-pushed
the
fix/move-mail-documentation
branch
from
6f5629b to
92af00b
Compare
SebastianKrupinski
left a comment
SebastianKrupinski
left a comment
There was a problem hiding this comment.
Just some minor adjustments
|
|
||
| sudo -E -u www-data php occ mail:account:debug <accountId> --on | ||
|
|
||
| All subsequent outgoing connections made by the mail app will then be written to the ``data`` directory. The file naming follows the following format: ``mail-{{userId}}-{{accountId}}-{{protocol}}.log`` (e.g., `mail-admin-49-imap.log`). |
There was a problem hiding this comment.
I would make its '{installation folder}/data'
There was a problem hiding this comment.
Hmm, I've checked the other documentation files and all of them just expect you to be in the root directory of the nextcloud installation. I would stick to that scheme for consistency? Otherwise, we should include that in the cli commands as well...
| sudo -E -u www-data php occ config:system:set debug --value true --type bool | ||
| sudo -E -u www-data php occ config:system:set loglevel --value 0 --type int | ||
|
|
||
| All subsequent outgoing connections made by the mail app will then be written to the ``data`` directory. The file naming follows the following format: ``horde_{{protocol}}.log`` (e.g., `horde_imap.log`). |
…tral documentation Signed-off-by: David Dreschner <[email protected]>
DerDreschner
force-pushed
the
fix/move-mail-documentation
branch
from
92af00b to
0f673fa
Compare
|
Thanks for your first pull request and welcome to the community! Feel free to keep them coming! If you are looking for issues to tackle then have a look at this selection: https://github.com/nextcloud/documentation/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22 |
The troubleshooting articles for mail should have their own section. Currently, they are listed under calendar. To add a new section after the content for contacts: |
|
Ohh, good point! 😅 Looks like my brain did some hallucination there last week 🙈 Fix is on its way |
We should mention in the user manual that Mail supports keyboard shortcuts, but link users to the Mail app itself for the full list. The shortcut list may change, for example shortcuts like K and J no longer exist. Even the list of keyboard shortcuts shown in the Mail app itself seems to be inaccurate 🙈 For example, |
|
Agree with @kesselb |
|
/backport to stable32 |
☑️ Resolves
For historical reasons, the groupware team had some admin and user documentation for the mail app within their repository. This isn't ideal as it creates different "sources of truth".
Therefore, this PR integrates the content from there and updates the documentation about debug logging for IMAP/SMTP/Sieve as well as an updated link to the Mozilla wiki for the autoconfig feature.
🖼️ Screenshots
Mail app page
Troubleshooting page
Added keyboard shortcut in user manual