Skip to content

Feature: Update to docusaurus 3.10.0#144

Merged
infeo merged 9 commits intodevelopfrom
feature/docusaurus-3.10.0
May 5, 2026
Merged

Feature: Update to docusaurus 3.10.0#144
infeo merged 9 commits intodevelopfrom
feature/docusaurus-3.10.0

Conversation

@infeo
Copy link
Copy Markdown
Member

@infeo infeo commented Apr 28, 2026

This PR updates the project to the recently released docusaurus 3.10.0.

To be prepared for docusaurus 4.0 and following recommended migrations, some additional changes were applied:

  • follow the strict MDX suggestion: file extensions, comments, etc.
  • enable docusaurus faster

@infeo infeo self-assigned this Apr 28, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 28, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: abb48f43-55e1-433e-9aca-5e4bcddcf5d9

📥 Commits

Reviewing files that changed from the base of the PR and between caf1bf5 and 7513e78.

📒 Files selected for processing (1)
  • .github/workflows/update-windows-info.yml

Walkthrough

Converts explicit in-heading MD anchor syntax {#...} to JSX-commented anchors ({/* #... */}) across many MDX docs, updates internal links from .md to .mdx, normalizes some admonition syntaxes, updates the GitHub Actions workflow to target docs/security/verify-installers.mdx and use JSX-style automation markers, enables future.faster in docusaurus.config.ts, and upgrades Docusaurus packages to 3.10.0 in package.json.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • overheadhunter
  • SailReal
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the primary change: updating the project to Docusaurus 3.10.0. It is concise, specific, and clearly communicates the main objective of the PR.
Description check ✅ Passed The description is well-related to the changeset, explaining the Docusaurus 3.10.0 upgrade and additional migration changes (strict MDX compliance and faster mode) that align with the files modified in the PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/docusaurus-3.10.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/1 reviews remaining, refill in 60 minutes.

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 9

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
docs/desktop/setup.mdx (2)

9-9: ⚠️ Potential issue | 🟡 Minor

Remove trailing whitespace on this line.

Line 9 ends with an extra trailing space after the period (“Linux. ”). In stricter doc/MDX linting setups, trailing whitespace can cause failures.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/desktop/setup.mdx` at line 9, Remove the trailing whitespace at the end
of the sentence "The Desktop version of Cryptomator is currently available for
Windows, macOS, and Linux." in the docs/desktop/setup.mdx file so the line ends
with "Linux." (no extra space); locate the exact string in the file and trim the
trailing space to satisfy MDX/markdown linting.

41-41: ⚠️ Potential issue | 🟡 Minor

Remove trailing whitespace on this line.

Line 41 ends with an extra trailing space after “distributions.” (“distributions. ”). Please trim it to avoid formatting/lint noise.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/desktop/setup.mdx` at line 41, Remove the trailing whitespace at the end
of the sentence that begins "The easiest and recommended way of installing
Cryptomator on Linux is by downloading Cryptomator's AppImage (an `.appimage`
file) - as it works on almost all distributions." in docs/desktop/setup.mdx by
editing that line and deleting the extra space after "distributions." so the
line ends cleanly with the period.
🧹 Nitpick comments (1)
docs/android/vault-management.mdx (1)

35-35: Use relative file links instead of /docs/... paths for portability.

Docusaurus documentation explicitly marks /docs/... links as less portable, requiring manual updates if you create new doc versions or localize the docs. Use relative file paths (e.g., ../path/file.mdx) instead, which automatically resolve to the correct version-specific and locale-specific URLs.

Also applies to: 67-67, 93-93, 162-162

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/android/vault-management.mdx` at line 35, Replace the absolute /docs/...
link with a relative file link so it resolves correctly for versions and
locales: locate the link text "Cloud Services With WebDAV Support" that
currently points to
/docs/misc/supported-cloud-services.mdx#cloud-services-with-webdav-support and
change it to a relative path (for example
../misc/supported-cloud-services.mdx#cloud-services-with-webdav-support). Do the
same replacement for the other occurrences mentioned (lines referencing the same
supported-cloud-services.mdx target) so all links use the relative ../misc/...
path instead of the leading /docs/.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/workflows/update-windows-info.yml:
- Line 67: Update the workflow to reference the correct file name
verify-installers.mdx everywhere it currently uses verify-installers.md: change
the workflow name string, the step name that mentions the document, the $DocPath
assignment (set to verify-installers.mdx), both error message strings that
mention the .md filename, and the git stage command to stage
verify-installers.mdx instead of the .md file so all steps (step names, $DocPath
variable, error messages, and the git add/git stage invocation) consistently
point to verify-installers.mdx.

In `@docs/desktop/password-and-recovery-key.mdx`:
- Line 17: The sentence "It is a human readable form of your decrypted
[masterkey]..." should use a hyphenated compound adjective; change "human
readable" to "human-readable" so it reads "It is a human-readable form of your
decrypted [masterkey]..." to improve correctness and consistency.

In `@docs/desktop/setup.mdx`:
- Line 17: Remove the trailing spaces at the ends of the two lines that end with
"Linux." and "distributions." in the document (the section headed "## Install
Cryptomator on Windows {/* `#install-cryptomator-on-windows` */}"); open the file,
delete the extra space characters after those words so the lines end cleanly,
and save the file (or run a trim-whitespace formatter to ensure no other
trailing spaces remain).

In `@docs/hub/access-vault.mdx`:
- Line 34: Replace the ungrammatical phrase "If you just did setup your account,
a vault owner needs to grant you access for the requested vault..." with correct
wording such as "If you have just set up your account, a vault owner needs to
grant you access for the requested vault as described
[here](vault-management.mdx#update-permissions). Retry unlocking the vault after
the vault owner grants you access." Locate and update the sentence that begins
"If you just did setup your account..." in docs/hub/access-vault.mdx (the
sentence text is a unique identifier) to use "have just set up" or "just set up"
and adjust verb tense consistency ("grants" instead of "granted") as shown.

In `@docs/hub/deployment.mdx`:
- Line 23: Replace the incorrect verb form "login" with the phrasal verb "log
in" in the sentence shown (the string "You can now login to Cryptomator Hub and
start [creating vaults](vault-management.mdx) or [add
users](user-group-management.mdx)."); update it to "You can now log in to
Cryptomator Hub and start ..." so the user-facing docs use the correct verb
form.

In `@docs/hub/vault-management.mdx`:
- Line 75: Update the phrase "human readable form of the vault [masterkey]" to
use the hyphenated compound adjective "human-readable" so it reads
"human-readable form of the vault [masterkey]"; locate the exact sentence in the
docs where the string "human readable form of the vault [masterkey]" appears (in
the vault-management.mdx content) and replace with "human-readable" to correct
the grammar.

In `@docs/misc/supported-cloud-services.mdx`:
- Line 52: Change the user-facing phrase "so called" to the hyphenated
"so-called" in the footnote text identified by the marker [^file-providers] (the
sentence starting "Some Android and iOS apps integrate into the operating
system's file manager... to allow seamless access to their files via so called
"File Providers."). Update that occurrence to "so-called" so the documentation
uses correct hyphenation.

In `@docs/security/architecture.mdx`:
- Line 77: Fix the typo in the user-facing sentence that reads "the encrypted
raw masterkey can be retrieved from a the server component" by removing the
extraneous "a" so it reads "the encrypted raw masterkey can be retrieved from
the server component"; edit the sentence in docs/security/architecture.mdx
accordingly.
- Line 77: Fix the typo in docs/security/architecture.mdx where the sentence
"When using [Cryptomator Hub](/docs/hub/access-vault.mdx), the encrypted raw
masterkey can be retrieved from a the server component." contains "from a the";
change it to "from the" so the sentence reads "...can be retrieved from the
server component." Reference the sentence containing "encrypted raw masterkey"
to locate the change.

---

Outside diff comments:
In `@docs/desktop/setup.mdx`:
- Line 9: Remove the trailing whitespace at the end of the sentence "The Desktop
version of Cryptomator is currently available for Windows, macOS, and Linux." in
the docs/desktop/setup.mdx file so the line ends with "Linux." (no extra space);
locate the exact string in the file and trim the trailing space to satisfy
MDX/markdown linting.
- Line 41: Remove the trailing whitespace at the end of the sentence that begins
"The easiest and recommended way of installing Cryptomator on Linux is by
downloading Cryptomator's AppImage (an `.appimage` file) - as it works on almost
all distributions." in docs/desktop/setup.mdx by editing that line and deleting
the extra space after "distributions." so the line ends cleanly with the period.

---

Nitpick comments:
In `@docs/android/vault-management.mdx`:
- Line 35: Replace the absolute /docs/... link with a relative file link so it
resolves correctly for versions and locales: locate the link text "Cloud
Services With WebDAV Support" that currently points to
/docs/misc/supported-cloud-services.mdx#cloud-services-with-webdav-support and
change it to a relative path (for example
../misc/supported-cloud-services.mdx#cloud-services-with-webdav-support). Do the
same replacement for the other occurrences mentioned (lines referencing the same
supported-cloud-services.mdx target) so all links use the relative ../misc/...
path instead of the leading /docs/.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 992e4e75-1dce-44b5-bc84-424b9cf6f5be

📥 Commits

Reviewing files that changed from the base of the PR and between dfd1044 and caf1bf5.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (57)
  • .github/workflows/update-windows-info.yml
  • docs/android/access-vault.mdx
  • docs/android/cloud-management.mdx
  • docs/android/index.mdx
  • docs/android/settings.mdx
  • docs/android/setup.mdx
  • docs/android/vault-management.mdx
  • docs/desktop/accessing-vaults.mdx
  • docs/desktop/adding-vaults.mdx
  • docs/desktop/admin-config.mdx
  • docs/desktop/common-errors.mdx
  • docs/desktop/encrypted-file-names.mdx
  • docs/desktop/error-handling.mdx
  • docs/desktop/files-in-use.mdx
  • docs/desktop/getting-started.mdx
  • docs/desktop/index.mdx
  • docs/desktop/network.mdx
  • docs/desktop/password-and-recovery-key.mdx
  • docs/desktop/setup.mdx
  • docs/desktop/sync-conflicts.mdx
  • docs/desktop/troubleshooting.mdx
  • docs/desktop/vault-events.mdx
  • docs/desktop/vault-management.mdx
  • docs/desktop/vault-recovery.mdx
  • docs/desktop/volume-type.mdx
  • docs/hub/access-vault.mdx
  • docs/hub/admin.mdx
  • docs/hub/deployment.mdx
  • docs/hub/early-access.mdx
  • docs/hub/emergency-access.mdx
  • docs/hub/index.mdx
  • docs/hub/introduction.mdx
  • docs/hub/user-group-management.mdx
  • docs/hub/vault-management.mdx
  • docs/hub/vault-recovery.mdx
  • docs/hub/your-account.mdx
  • docs/ios/access-vault.mdx
  • docs/ios/cloud-management.mdx
  • docs/ios/index.mdx
  • docs/ios/settings.mdx
  • docs/ios/setup.mdx
  • docs/ios/shortcuts-guide.mdx
  • docs/ios/vault-management.mdx
  • docs/misc/contribute.mdx
  • docs/misc/index.mdx
  • docs/misc/manual-migration.mdx
  • docs/misc/supported-cloud-services.mdx
  • docs/misc/vault-format-history.mdx
  • docs/security/architecture.mdx
  • docs/security/best-practices.mdx
  • docs/security/hub.mdx
  • docs/security/index.mdx
  • docs/security/security-target.mdx
  • docs/security/vault.mdx
  • docs/security/verify-installers.mdx
  • docusaurus.config.ts
  • package.json

Comment thread .github/workflows/update-windows-info.yml
Comment thread docs/desktop/password-and-recovery-key.mdx
Comment thread docs/desktop/setup.mdx
Comment thread docs/hub/access-vault.mdx
Comment thread docs/hub/deployment.mdx
Comment thread docs/hub/vault-management.mdx
Comment thread docs/misc/supported-cloud-services.mdx
Comment thread docs/security/architecture.mdx
@infeo infeo merged commit b643900 into develop May 5, 2026
2 checks passed
@infeo infeo deleted the feature/docusaurus-3.10.0 branch May 5, 2026 13:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant