Conversation
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
WalkthroughConverts explicit in-heading MD anchor syntax Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related PRs
Suggested reviewers
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Review rate limit: 0/1 reviews remaining, refill in 60 minutes.Comment |
There was a problem hiding this comment.
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 | 🟡 MinorRemove 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 | 🟡 MinorRemove 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
⛔ Files ignored due to path filters (1)
package-lock.jsonis excluded by!**/package-lock.json
📒 Files selected for processing (57)
.github/workflows/update-windows-info.ymldocs/android/access-vault.mdxdocs/android/cloud-management.mdxdocs/android/index.mdxdocs/android/settings.mdxdocs/android/setup.mdxdocs/android/vault-management.mdxdocs/desktop/accessing-vaults.mdxdocs/desktop/adding-vaults.mdxdocs/desktop/admin-config.mdxdocs/desktop/common-errors.mdxdocs/desktop/encrypted-file-names.mdxdocs/desktop/error-handling.mdxdocs/desktop/files-in-use.mdxdocs/desktop/getting-started.mdxdocs/desktop/index.mdxdocs/desktop/network.mdxdocs/desktop/password-and-recovery-key.mdxdocs/desktop/setup.mdxdocs/desktop/sync-conflicts.mdxdocs/desktop/troubleshooting.mdxdocs/desktop/vault-events.mdxdocs/desktop/vault-management.mdxdocs/desktop/vault-recovery.mdxdocs/desktop/volume-type.mdxdocs/hub/access-vault.mdxdocs/hub/admin.mdxdocs/hub/deployment.mdxdocs/hub/early-access.mdxdocs/hub/emergency-access.mdxdocs/hub/index.mdxdocs/hub/introduction.mdxdocs/hub/user-group-management.mdxdocs/hub/vault-management.mdxdocs/hub/vault-recovery.mdxdocs/hub/your-account.mdxdocs/ios/access-vault.mdxdocs/ios/cloud-management.mdxdocs/ios/index.mdxdocs/ios/settings.mdxdocs/ios/setup.mdxdocs/ios/shortcuts-guide.mdxdocs/ios/vault-management.mdxdocs/misc/contribute.mdxdocs/misc/index.mdxdocs/misc/manual-migration.mdxdocs/misc/supported-cloud-services.mdxdocs/misc/vault-format-history.mdxdocs/security/architecture.mdxdocs/security/best-practices.mdxdocs/security/hub.mdxdocs/security/index.mdxdocs/security/security-target.mdxdocs/security/vault.mdxdocs/security/verify-installers.mdxdocusaurus.config.tspackage.json
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: