fix(user): prose quality fixes across user manual (MED severity) by miaulalala · Pull Request #14642 · nextcloud/documentation

miaulalala · 2026-04-26T21:37:09Z

Thirteen targeted prose fixes across the user manual: clearer phrasing, corrected
grammar, removed editorial tone, and improved technical accuracy.

Changes by area:

files/: encrypting_files (informal "snoop in"), version_control (clarified 2-minute interval), file_drop (missing verb + formatting), transfer_ownership (rewrote confusing
ownership sentence), access_webdav (softened macOS Finder wording), desktop_mobile_sync (removed "Unfortunately" and editorialising)
talk/: call.rst (simplified circular push-to-talk description), attachments.rst (replaced "irrespective of them having"), federation_index.rst (added CloudID definition),
call_recording.rst (replaced vague "some time" with "a few minutes")
groupware/: mail.rst (three prose errors: "re- open", "than"→"that", subject–verb agreement)
desktop/: configfile.rst ("port were" → "port where"), envvars.rst (added note that env var is legacy ownCloud name still used by Nextcloud) e blocks, headers and links look.

✅ Checklist

I have built the documentation locally and reviewed the output
Screenshots are included for visual changes
I have not moved or renamed pages (or added a redirect if I did)
I have run codespell or similar and addressed any spelling issues

….rst "administrator to snoop in your files" → "administrator to access your unencrypted files" — more precise and professional. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

…l.rst "Changes made at intervals greater than two minutes are saved" implied that only changes after a 2-minute gap are saved, rather than explaining the minimum interval between saved versions. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

"Check Share Link, Allow editing, Hide file listing:" had no verb and no formatting. Rewritten as "Enable Share Link, Allow editing, and Hide file listing:". AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

….rst "Sharing ownerships of those transferred files/folders will also be transferred" was awkward. Rewritten for clarity. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

"suffers from a series of implementation problems" → "has known compatibility issues with WebDAV" — less dramatic, more neutral tone. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

"Unfortunately" removed; phrasing made neutral and direct. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

The two-clause explanation was redundant. Simplified to one sentence. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

…chments.rst → "regardless of whether they have a Nextcloud account" AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

The page explained how to find your CloudID but never defined what it is. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

…ording.rst AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

"re- open" → "reopen"; spurious hyphen on "send-" removed "state than can be retried" → "state that can be retried" "Event title and an agenda is created" → "An event title and agenda are created" AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

…_BYTES AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

miaulalala · 2026-04-26T21:37:36Z

/backport to stable33

ChristophWurst

👍 for groupware

ChristophWurst · 2026-04-27T04:24:44Z

 - `OWNCLOUD_CHUNK_SIZE` (default: 5242880; 5 MiB) – Specifies the chunk size of uploaded files in bytes. Increasing this value may help with synchronization problems in certain configurations.  
 - `OWNCLOUD_TIMEOUT` (default: 300 s) – The timeout for network connections in seconds.
- `OWNCLOUD_CRITICAL_FREE_SPACE_BYTES` (default: 512\*1000\*1000 bytes) - The minimum disk space needed for operation. A fatal error is raised if less free space is available. 
+- `OWNCLOUD_CRITICAL_FREE_SPACE_BYTES` (default: 512\*1000\*1000 bytes) - The minimum disk space needed for operation. A fatal error is raised if less free space is available. (Legacy variable name from ownCloud; still used by Nextcloud.)


Why would the name hint be noted just for this var?

ChristophWurst · 2026-04-27T04:26:07Z

-Unfortunately, 2-way-sync, a.k.a bidirectional sync, isn't fully implemented in
-the Android client yet. See `this issue on GitHub <https://github.com/nextcloud/android/issues/19>`_
-for the current feature's status.
+Bidirectional sync (2-way-sync) is not yet fully implemented in the Android


Doesn't "yet" require present perfect?

I think we have this by now

nickvergessen · 2026-04-27T04:59:38Z

    :width: 500px

-After stopping a recording, the server will take some time to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.
+After stopping a recording, the server will take a few minutes to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.


Suggested change

After stopping a recording, the server will take a few minutes to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.

After stopping a recording, the server will take a few seconds to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.

It's usually 3 of them

nickvergessen · 2026-04-27T05:00:30Z

-Unfortunately, 2-way-sync, a.k.a bidirectional sync, isn't fully implemented in
-the Android client yet. See `this issue on GitHub <https://github.com/nextcloud/android/issues/19>`_
-for the current feature's status.
+Bidirectional sync (2-way-sync) is not yet fully implemented in the Android


I think we have this by now

nickvergessen · 2026-04-27T05:01:44Z

 ---------------------------

-.. note:: The macOS Finder suffers from a `series of implementation problems <http://sabre.io/dav/clients/finder/>`_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck <https://cyberduck.io/>`_ (see instructions `here <#accessing-files-using-cyberduck>`_) and `Filezilla <https://filezilla-project.org>`_. Commercial clients include `Mountain Duck <https://mountainduck.io/>`_, `Forklift <https://binarynights.com/>`_, `Transmit <https://panic.com/>`_, and `Commander One <https://mac.eltima.com/>`_.
+.. note:: macOS Finder has `known compatibility issues <http://sabre.io/dav/clients/finder/>`_ with WebDAV and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck <https://cyberduck.io/>`_ (see instructions `here <#accessing-files-using-cyberduck>`_) and `Filezilla <https://filezilla-project.org>`_. Commercial clients include `Mountain Duck <https://mountainduck.io/>`_, `Forklift <https://binarynights.com/>`_, `Transmit <https://panic.com/>`_, and `Commander One <https://mac.eltima.com/>`_.


I have the suspicion this is very old.
Maybe you can ask the desktop team?

miaulalala added 13 commits April 26, 2026 17:42

fix(user): remove editorialising from desktop_mobile_sync.rst

022af00

"Unfortunately" removed; phrasing made neutral and direct. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): simplify circular push-to-talk description in talk/call.rst

d6a7c50

The two-clause explanation was redundant. Simplified to one sentence. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): replace awkward "irrespective of them having" in talk/atta…

c2663c5

…chments.rst → "regardless of whether they have a Nextcloud account" AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): add CloudID definition to talk/federation_index.rst

266afc6

The page explained how to find your CloudID but never defined what it is. AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): replace vague "some time" with "a few minutes" in call_rec…

19a9ed0

…ording.rst AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): fix "port were" → "port where" in desktop/configfile.rst

a64fd67

AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

fix(user): note legacy ownCloud name for OWNCLOUD_CRITICAL_FREE_SPACE…

007d13f

…_BYTES AI-Assisted-By: claude-sonnet-4-6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>

miaulalala added this to the Nextcloud 34 milestone Apr 26, 2026

miaulalala requested a review from skjnldsv April 26, 2026 21:37

miaulalala self-assigned this Apr 26, 2026

miaulalala added the bug label Apr 26, 2026

miaulalala requested a review from Antreesy as a code owner April 26, 2026 21:37

miaulalala added the 3. to review label Apr 26, 2026

miaulalala requested review from ChristophWurst, DorraJaouad and nickvergessen as code owners April 26, 2026 21:37

miaulalala added the manual: user label Apr 26, 2026

miaulalala requested review from GretaD and kesselb as code owners April 26, 2026 21:37

backportbot Bot added the backport-request label Apr 26, 2026

ChristophWurst reviewed Apr 27, 2026

View reviewed changes

nickvergessen requested changes Apr 27, 2026

View reviewed changes

skjnldsv enabled auto-merge April 27, 2026 06:01

skjnldsv approved these changes Apr 27, 2026

View reviewed changes

nickvergessen disabled auto-merge April 27, 2026 07:22

nickvergessen marked this pull request as draft April 27, 2026 07:22

skjnldsv added 2. developing and removed 3. to review labels Apr 29, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(user): prose quality fixes across user manual (MED severity)#14642

fix(user): prose quality fixes across user manual (MED severity)#14642
miaulalala wants to merge 13 commits intomasterfrom
fix/user-encrypting-files

miaulalala commented Apr 26, 2026

Uh oh!

miaulalala commented Apr 26, 2026

Uh oh!

ChristophWurst left a comment

Uh oh!

ChristophWurst Apr 27, 2026

Uh oh!

ChristophWurst Apr 27, 2026

Uh oh!

nickvergessen Apr 27, 2026

Uh oh!

nickvergessen Apr 27, 2026

Uh oh!

nickvergessen Apr 27, 2026

Uh oh!

nickvergessen Apr 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

	After stopping a recording, the server will take a few minutes to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.
	After stopping a recording, the server will take a few seconds to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.

Conversation

miaulalala commented Apr 26, 2026

✅ Checklist

Uh oh!

miaulalala commented Apr 26, 2026

Uh oh!

ChristophWurst left a comment

Choose a reason for hiding this comment

Uh oh!

ChristophWurst Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

ChristophWurst Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

nickvergessen Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

nickvergessen Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

nickvergessen Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

nickvergessen Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants