Skip to content

docs: add Unraid 7.3 onboarding wizard flow#414

Open
ljm42 wants to merge 4 commits intomainfrom
feature/internal-boot
Open

docs: add Unraid 7.3 onboarding wizard flow#414
ljm42 wants to merge 4 commits intomainfrom
feature/internal-boot

Conversation

@ljm42
Copy link
Member

@ljm42 ljm42 commented Mar 12, 2026

Before Submitting This PR, Please Ensure You Have Completed The Following:

  1. Are internal links to wiki documents using relative file links?
  2. Are all new documentation files lowercase, with dash separated names (ex. unraid-os.mdx)?
  3. Are all assets (images, etc), located in an assets/ subfolder next to the .md/mdx files?
  4. Have you checked to ensure there aren't other open Pull Requests for the same update/change?
  5. Is the build succeeding?

Summary by CodeRabbit

  • Documentation
    • Expanded Onboarding with a multi‑step wizard, screenshots and relaunch steps for Unraid 7.3+
    • Added comprehensive 7.3.0 (beta) release notes: upgrade/rollback guidance, known issues, and detailed changes vs 7.2.4
    • Standardized wording, capitalization, headings, list formatting and inline style for improved readability
    • Replaced “flash drive” wording with “boot device” across many docs and updated related links
  • New Features
    • Added TPM‑based licensing guidance and updated license transfer/registration workflows

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 12, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds Onboarding wizard content (Unraid 7.3+), introduces TPM-based licensing guidance and boot-device terminology throughout docs, adds 7.3.0 release notes, and applies wide formatting and wording standardization across many MDX files and i18n variants.

Changes

Cohort / File(s) Summary
Onboarding & Deploy guide
docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx
Inserted multi-step Onboarding wizard content and images for Unraid 7.3+; reworked license registration instructions and images; standardized inline style quotes, spacing, punctuation, heading capitalization, and list/MDX block formatting.
Release notes
docs/unraid-os/release-notes/7.3.0.md
Added 7.3.0-beta.1 release notes (2026-03-17) with upgrading/rollback guidance, Known issues, and detailed Changes vs 7.2.4 (Onboarding, Licensing incl. TPM, Storage/ZFS, WebGUI, Virtualization, Unraid API, kernel and base distro package updates).
Licensing, TPM & boot-device docs
docs/unraid-os/troubleshooting/licensing-faq.mdx, docs/unraid-os/system-administration/secure-your-server/secure-your-boot-drive.mdx, docs/unraid-os/troubleshooting/partials/licensing-faq/*, docs/unraid-os/.../secure-your-boot-drive.mdx
Added TPM-based licensing workflow, transfer steps, BIOS/TPM prerequisites, and multiple-scenario guidance; renamed/rewrote license installation headings; updated terminology from “flash” to “boot device” and adjusted related paths and tips.
Wide boot-device term and style updates
docs/unraid-os/getting-started/.../*.mdx, docs/unraid-os/system-administration/.../*.mdx, docs/unraid-os/troubleshooting/.../*.mdx, docs/unraid-os/using-unraid-to/.../*.mdx
Replaced “flash/flash drive” wording with “boot device/boot drive” across many docs; standardized emphasis/heading styling (triple-asterisk), punctuation, spacing, and small wording fixes without functional changes.
Config, glossary, redirects, i18n
docusaurus.config.ts, glossary.yaml, i18n/**/docusaurus-plugin-content-docs/current/**
Updated redirect mappings to the secure boot-drive page; adjusted GUID glossary definition to mention TPM-based hardware identity; updated localized docs to point to boot-drive content.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 I hopped through lines of text at night,
I swapped "flash" for "boot" by lantern light,
Brought onboarding steps and TPM in tune,
Tidied headings, links — a docs cocoon,
Nibbles, hops, and carrot-coded delight 🥕

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The pull request description matches the required template but is incomplete; the author has not checked off the required checklist items, leaving all boxes unchecked. Complete the pre-submission checklist by verifying and checking each item to confirm compliance with internal links, file naming, asset organization, duplicate PR checks, and build status.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the primary focus of the changeset—adding documentation for the Unraid 7.3 onboarding wizard flow.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/internal-boot
📝 Coding Plan
  • Generate coding plan for human review comments

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

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

Tip

You can make CodeRabbit's review stricter and more nitpicky using the `assertive` profile, if that's what you prefer.

Change the reviews.profile setting to assertive to make CodeRabbit's nitpick more issues in your PRs.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Mar 12, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
unraid-docs 77c06df Commit Preview URL

Branch Preview URL
Mar 16 2026, 09:46 PM

Copy link
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: 1

🧹 Nitpick comments (1)
docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx (1)

140-159: Use semantic lists for the BIOS checklist.

These checklist items are plain lines with hard breaks, which is brittle in MDX and less friendly for accessibility/translation tooling. Converting them to actual list items will render more consistently and be easier to maintain.

Suggested shape
 ### Basic Settings

-✅ Set the USB flash drive as the primary boot device.\
- ✅ Configure the storage controller to **%%AHCI|ahci%%** mode with SATA connections.\
- ✅ Set the controller to **%%HBA mode|hba-mode%%** (not **%%RAID|raid%%**).\
- ✅ Disable **Secure Boot** as it is not supported by Unraid OS.
+- ✅ Set the USB flash drive as the primary boot device.
+- ✅ Configure the storage controller to **%%AHCI|ahci%%** mode with SATA connections.
+- ✅ Set the controller to **%%HBA mode|hba-mode%%** (not **%%RAID|raid%%**).
+- ✅ Disable **Secure Boot** because it is not supported by Unraid OS.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`
around lines 140 - 159, Convert the hard‑wrapped checklist lines under the
"Basic Settings", "Advanced Settings", and "Troubleshooting Tips" headings into
proper semantic Markdown/MDX lists (e.g., unordered lists or task list items
like - [x]) so each checkbox becomes a real list item; update the lines
containing the checklist tokens (e.g., "Set the USB flash drive as the primary
boot device.", "Configure the storage controller to **%%AHCI|ahci%%** mode...",
"Enable **%%hardware virtualization|hvm%%**...", and the troubleshooting
entries) to be list items rather than plain text with trailing backslashes,
preserving the inline tokens (%%...%%) and check states.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 107-123: The "Register your license key" section currently targets
Unraid 7.2 and earlier but doesn't cover the Unraid 7.3+ onboarding flow; either
add a new "For Unraid 7.3 and later" subsection under the same heading that
describes the new registration path (what UI entry point to use during
first-boot onboarding or the updated WebGUI flow, and screenshots to match) or
explicitly mark the existing content as "Legacy (7.2 and earlier)". Update or
add text and images referenced in the section (the "Get Started" and "Install
trial key" descriptions) to reflect the correct steps for 7.3+, and keep the
heading "Register your license key" so readers can find both legacy and
current-version guidance.

---

Nitpick comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 140-159: Convert the hard‑wrapped checklist lines under the "Basic
Settings", "Advanced Settings", and "Troubleshooting Tips" headings into proper
semantic Markdown/MDX lists (e.g., unordered lists or task list items like -
[x]) so each checkbox becomes a real list item; update the lines containing the
checklist tokens (e.g., "Set the USB flash drive as the primary boot device.",
"Configure the storage controller to **%%AHCI|ahci%%** mode...", "Enable
**%%hardware virtualization|hvm%%**...", and the troubleshooting entries) to be
list items rather than plain text with trailing backslashes, preserving the
inline tokens (%%...%%) and check states.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: f03ebcf7-9904-487a-b644-397031a650d1

📥 Commits

Reviewing files that changed from the base of the PR and between 4d3ae19 and 25303ed.

⛔ Files ignored due to path filters (7)
  • static/img/onboarding_step1.png is excluded by !**/*.png
  • static/img/onboarding_step2.png is excluded by !**/*.png
  • static/img/onboarding_step3a.png is excluded by !**/*.png
  • static/img/onboarding_step3b.png is excluded by !**/*.png
  • static/img/onboarding_step4.png is excluded by !**/*.png
  • static/img/onboarding_step5.png is excluded by !**/*.png
  • static/img/onboarding_step6.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx

Copy link
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: 1

♻️ Duplicate comments (1)
docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx (1)

107-127: ⚠️ Potential issue | 🟠 Major

Document the 7.3+ registration entry point or mark this as legacy.

After the new onboarding section, this block still drops readers into the older Get Started registration flow without saying whether it applies to 7.3+. That leaves current-version users without a clear handoff from onboarding to license registration. Please either add the 7.3+ path here or explicitly label this section as a legacy 7.2-and-earlier flow.

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

In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`
around lines 107 - 127, The "Register your license key" section currently points
users to the older "Get Started" flow (mentions %%WebGUI|web-gui%% and "Get
Started") but doesn't state whether it applies to 7.3+; update the section to
either (A) add the 7.3+ registration entry point after the onboarding flow
(describe where to find license registration in 7.3+ and update
screenshots/labels accordingly), or (B) explicitly mark this section as "Legacy
(7.2 and earlier)" and link to the new 7.3+ onboarding documentation; update the
heading or callout text (the "Register your license key" heading, the "Get
Started" references, and the "Tools → Registration" note) so readers have a
clear handoff for current-version users.
🧹 Nitpick comments (1)
docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx (1)

61-105: Colocate the new screenshots with this doc instead of /img.

These newly added images are still referenced from the global /img bucket, which makes the page harder to maintain and drifts from the contributor checklist for new doc assets. Please move them into an adjacent assets/ folder and switch the references to relative paths/imports.

Example pattern
- ![Step 1: Welcome to Unraid](/img/onboarding_step1.png)
+ ![Step 1: Welcome to Unraid](./assets/onboarding-step1.png)

Apply the same pattern to the other new onboarding and registration screenshots.

Also applies to: 113-120

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

In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`
around lines 61 - 105, The new onboarding screenshots in
deploy-and-configure-unraid-os.mdx are referenced from the global /img bucket;
move those image files into a local assets/ directory adjacent to this MDX and
update the references in this file (e.g., change "/img/onboarding_step1.png"
etc.) to relative paths or imported asset variables (for example
"./assets/onboarding_step1.png" or import onboardingStep1 from
'./assets/onboarding_step1.png' and use {onboardingStep1}) so the images are
colocated with the document and follow the contributor checklist; apply the same
change for all other new onboarding/registration screenshots referenced in the
file (including the ones noted in the comment).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 53-57: The callout header text is inconsistent with the body;
update the note tag label from "Unraid 7.3 only" to match the body wording
(e.g., "Unraid 7.3 and later") by changing :::note[Unraid 7.3 only] to
:::note[Unraid 7.3 and later] so the callout and the sentence "The onboarding
wizard below applies to Unraid 7.3 and later." are consistent.

---

Duplicate comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 107-127: The "Register your license key" section currently points
users to the older "Get Started" flow (mentions %%WebGUI|web-gui%% and "Get
Started") but doesn't state whether it applies to 7.3+; update the section to
either (A) add the 7.3+ registration entry point after the onboarding flow
(describe where to find license registration in 7.3+ and update
screenshots/labels accordingly), or (B) explicitly mark this section as "Legacy
(7.2 and earlier)" and link to the new 7.3+ onboarding documentation; update the
heading or callout text (the "Register your license key" heading, the "Get
Started" references, and the "Tools → Registration" note) so readers have a
clear handoff for current-version users.

---

Nitpick comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 61-105: The new onboarding screenshots in
deploy-and-configure-unraid-os.mdx are referenced from the global /img bucket;
move those image files into a local assets/ directory adjacent to this MDX and
update the references in this file (e.g., change "/img/onboarding_step1.png"
etc.) to relative paths or imported asset variables (for example
"./assets/onboarding_step1.png" or import onboardingStep1 from
'./assets/onboarding_step1.png' and use {onboardingStep1}) so the images are
colocated with the document and follow the contributor checklist; apply the same
change for all other new onboarding/registration screenshots referenced in the
file (including the ones noted in the comment).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 1c7ce9be-d66d-4ed2-878e-ad29d434e3c6

📥 Commits

Reviewing files that changed from the base of the PR and between 25303ed and 36eb5cc.

📒 Files selected for processing (1)
  • docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx

@elibosley elibosley force-pushed the feature/internal-boot branch from 36eb5cc to 88fdb43 Compare March 12, 2026 13:47
Copy link
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: 1

♻️ Duplicate comments (1)
docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx (1)

53-57: ⚠️ Potential issue | 🟡 Minor

Make the version callout consistent.

Line 53 says "Unraid 7.3 only", but Line 55 says the wizard applies to "7.3 and later." These scopes conflict.

-:::note[Unraid 7.3 only]
+:::note[Unraid 7.3 and later]
 
 The onboarding wizard below applies to Unraid 7.3 and later.

,

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

In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`
around lines 53 - 57, The callout label ":::note[Unraid 7.3 only]" conflicts
with the following sentence "The onboarding wizard below applies to Unraid 7.3
and later." Update one of them so both state the same scope: either change the
callout label to ":::note[Unraid 7.3 and later]" to match the sentence, or
change the sentence to "The onboarding wizard below applies to Unraid 7.3 only."
Make the edit in the deploy-and-configure-unraid-os.mdx file by updating the
text inside the callout tag or the sentence accordingly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 142-159: Normalize the leading spaces for all checklist lines so
indentation is consistent: remove the extra leading spaces before "Set the USB
flash drive as the primary boot device", "Configure the storage controller to
**%%AHCI|ahci%%** mode with SATA connections", "Set the controller to **%%HBA
mode|hba-mode%%** (not **%%RAID|raid%%**)", "Disable **Secure Boot** as it is
not supported by Unraid OS", the Advanced Settings items such as "Enable
**%%hardware virtualization|hvm%%** features" and "Enable **%%IOMMU|iommu%%**
support", and the Troubleshooting Tips lines like "Adjusting the boot order to:
**Forced-FDD**, **USB-HDD**, **USB-ZIP**", ensuring every checklist line uses
the same leading whitespace (either none or one space) so rendered indentation
is uniform.

---

Duplicate comments:
In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`:
- Around line 53-57: The callout label ":::note[Unraid 7.3 only]" conflicts with
the following sentence "The onboarding wizard below applies to Unraid 7.3 and
later." Update one of them so both state the same scope: either change the
callout label to ":::note[Unraid 7.3 and later]" to match the sentence, or
change the sentence to "The onboarding wizard below applies to Unraid 7.3 only."
Make the edit in the deploy-and-configure-unraid-os.mdx file by updating the
text inside the callout tag or the sentence accordingly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: a07a4d44-7f69-49e0-b398-83685b22132b

📥 Commits

Reviewing files that changed from the base of the PR and between 36eb5cc and 88fdb43.

⛔ Files ignored due to path filters (7)
  • static/img/onboarding_step1.png is excluded by !**/*.png
  • static/img/onboarding_step2.png is excluded by !**/*.png
  • static/img/onboarding_step3a.png is excluded by !**/*.png
  • static/img/onboarding_step3b.png is excluded by !**/*.png
  • static/img/onboarding_step4.png is excluded by !**/*.png
  • static/img/onboarding_step5.png is excluded by !**/*.png
  • static/img/onboarding_step6.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx

Comment on lines +142 to +159
✅ Set the USB flash drive as the primary boot device.\
✅ Configure the storage controller to **%%AHCI|ahci%%** mode with SATA connections.\
✅ Set the controller to **%%HBA mode|hba-mode%%** (not **%%RAID|raid%%**).\
✅ Disable **Secure Boot** as it is not supported by Unraid OS.

### Advanced Settings
### Advanced Settings

✅ Enable **%%hardware virtualization|hvm%%** features (e.g., **%%Intel VT-x|intel-vt-x%%** or **%%AMD-V|amd-v%%**) for **%%virtual machines (VMs)|vm%%**.\
✅ Enable **%%IOMMU|iommu%%** support (Intel VT-d or AMD-Vi) for PCI device assignment to VMs.
✅ Enable **%%hardware virtualization|hvm%%** features (e.g., **%%Intel VT-x|intel-vt-x%%** or **%%AMD-V|amd-v%%**) for **%%virtual machines (VMs)|vm%%**.\
✅ Enable **%%IOMMU|iommu%%** support (Intel VT-d or AMD-Vi) for PCI device assignment to VMs.

### Troubleshooting Tips
### Troubleshooting Tips

If Unraid OS does not boot, try:
If Unraid OS does not boot, try:

✅ Adjusting the boot order to: **Forced-FDD**, **USB-HDD**, **USB-ZIP**.\
✅ Disabling USB 2.0/3.0 support.\
✅ Toggling any Fast Boot features.\
✅ Toggling USB keyboard support.
✅ Adjusting the boot order to: **Forced-FDD**, **USB-HDD**, **USB-ZIP**.\
✅ Disabling USB 2.0/3.0 support.\
✅ Toggling any Fast Boot features.\
✅ Toggling USB keyboard support.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Inconsistent leading spaces in checklist items.

Some checkmark items have a leading space (lines 143-145, 150, 157-159) while others don't (lines 142, 149, 154, 156). This creates inconsistent indentation in the rendered output.

 ✅ Set the USB flash drive as the primary boot device.\
- ✅ Configure the storage controller to **%%AHCI|ahci%%** mode with SATA connections.\
- ✅ Set the controller to **%%HBA mode|hba-mode%%** (not **%%RAID|raid%%**).\
- ✅ Disable **Secure Boot** as it is not supported by Unraid OS.
+✅ Configure the storage controller to **%%AHCI|ahci%%** mode with SATA connections.\
+✅ Set the controller to **%%HBA mode|hba-mode%%** (not **%%RAID|raid%%**).\
+✅ Disable **Secure Boot** as it is not supported by Unraid OS.
 
 ### Advanced Settings
 
 ✅ Enable **%%hardware virtualization|hvm%%** features (e.g., **%%Intel VT-x|intel-vt-x%%** or **%%AMD-V|amd-v%%**) for **%%virtual machines (VMs)|vm%%**.\
- ✅ Enable **%%IOMMU|iommu%%** support (Intel VT-d or AMD-Vi) for PCI device assignment to VMs.
+✅ Enable **%%IOMMU|iommu%%** support (Intel VT-d or AMD-Vi) for PCI device assignment to VMs.
 
 ### Troubleshooting Tips
 
 If Unraid OS does not boot, try:
 
 ✅ Adjusting the boot order to: **Forced-FDD**, **USB-HDD**, **USB-ZIP**.\
- ✅ Disabling USB 2.0/3.0 support.\
- ✅ Toggling any Fast Boot features.\
- ✅ Toggling USB keyboard support.
+✅ Disabling USB 2.0/3.0 support.\
+✅ Toggling any Fast Boot features.\
+✅ Toggling USB keyboard support.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os.mdx`
around lines 142 - 159, Normalize the leading spaces for all checklist lines so
indentation is consistent: remove the extra leading spaces before "Set the USB
flash drive as the primary boot device", "Configure the storage controller to
**%%AHCI|ahci%%** mode with SATA connections", "Set the controller to **%%HBA
mode|hba-mode%%** (not **%%RAID|raid%%**)", "Disable **Secure Boot** as it is
not supported by Unraid OS", the Advanced Settings items such as "Enable
**%%hardware virtualization|hvm%%** features" and "Enable **%%IOMMU|iommu%%**
support", and the Troubleshooting Tips lines like "Adjusting the boot order to:
**Forced-FDD**, **USB-HDD**, **USB-ZIP**", ensuring every checklist line uses
the same leading whitespace (either none or one space) so rendered indentation
is uniform.

Copy link
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: 5

🧹 Nitpick comments (6)
docs/unraid-os/troubleshooting/common-issues/data-recovery.mdx (1)

225-225: Use an absolute path for super.dat to reduce ambiguity.

At Line 225, consider formatting the path as /config/super.dat instead of config/super.dat so readers interpret it as a root-relative location on the boot device.

✏️ Suggested wording tweak
-Losing your %%array|array%% configuration can be stressful, but it doesn't mean your data is gone. The %%array|array%% configuration file (located at `config/super.dat` on your boot device) tells Unraid how your drives are assigned and which ones serve as %%parity|parity%%. If you've lost your boot device or don’t have a recent backup, you can recover your %%array|array%% by carefully reassigning the drives.
+Losing your %%array|array%% configuration can be stressful, but it doesn't mean your data is gone. The %%array|array%% configuration file (located at `/config/super.dat` on your boot device) tells Unraid how your drives are assigned and which ones serve as %%parity|parity%%. If you've lost your boot device or don’t have a recent backup, you can recover your %%array|array%% by carefully reassigning the drives.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/unraid-os/troubleshooting/common-issues/data-recovery.mdx` at line 225,
Update the documentation text that refers to the Unraid configuration file so
the path is absolute: change the referenced `config/super.dat` string to
`/config/super.dat` wherever it appears in the paragraph about losing your
%%array|array%% configuration (specifically in the sentence that mentions
"located at `config/super.dat` on your boot device") to make clear it is a
root-relative path on the boot device; keep the surrounding wording intact.
docs/unraid-os/system-administration/maintain-and-update/partials/backup-using-webgui.mdx (2)

4-6: Update screenshot alt text to match the new terminology.

The alt text still says Flash Backup, which now conflicts with the updated Boot Device Backup wording.

Proposed doc tweak
-  ![Flash Backup](/img/flashbackup.png)
+  ![Boot Device Backup](/img/flashbackup.png)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/unraid-os/system-administration/maintain-and-update/partials/backup-using-webgui.mdx`
around lines 4 - 6, Update the image alt text to use the new terminology:
replace the current alt text "Flash Backup" in the JSX img element (the node
rendering ![Flash Backup](/img/flashbackup.png)) with "Boot Device Backup" so
the alt attribute and any visible description match the updated wording across
the docs.

1-2: Consider clarifying what the downloaded ZIP is used for.

A short clause here (e.g., that the ZIP contains the full Unraid install/config and can be used in USB Flash Creator via Use custom) would make this step more self-contained for replacement workflows.

Based on learnings: Unraid’s flash backup ZIP includes OS + config and is restorable via USB Flash Creator’s “Use custom” option.

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

In
`@docs/unraid-os/system-administration/maintain-and-update/partials/backup-using-webgui.mdx`
around lines 1 - 2, Clarify what the downloaded ZIP from the "Boot Device
Backup" step contains and how it is used: update the text near the "Boot Device"
/ "Boot Device Backup" steps to add a short clause stating the ZIP contains the
full Unraid OS and configuration and can be used to recreate the USB by
selecting "Use custom" in the USB Flash Creator (so readers know it's restorable
for replacement workflows).
i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx (1)

55-55: Align link label text with the new boot-device terminology.

Line 55 updates the URL, but the sentence/link label still references “clé USB,” which is inconsistent with the destination page’s boot-device terminology.

Proposed wording update
-Avant d'installer, envisagez de sauvegarder votre clé USB pour protéger votre configuration. Consultez [Sécurisez votre clé USB](../../system-administration/secure-your-server/secure-your-boot-drive.mdx) pour obtenir des conseils de sauvegarde.
+Avant d'installer, envisagez de sauvegarder votre périphérique de démarrage pour protéger votre configuration. Consultez [Sécurisez votre périphérique de démarrage](../../system-administration/secure-your-server/secure-your-boot-drive.mdx) pour obtenir des conseils de sauvegarde.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx`
at line 55, Update the link label and surrounding sentence to use the
boot-device terminology instead of "clé USB": replace the visible text
"Sécurisez votre clé USB" (and the preceding "votre clé USB" in the sentence)
with "Sécurisez votre périphérique de démarrage" so the anchor text and sentence
match the destination page's terminology while keeping the existing URL.
i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx (1)

55-55: Update the visible Spanish wording to match the new boot-device target.

Line 55 updates the destination, but the sentence/link label still uses “flash,” which is inconsistent with the linked page.

Proposed wording update
-Antes de instalar, considera realizar una copia de seguridad de tu flash para proteger tu configuración. Consulta [Asegura tu unidad flash](../../system-administration/secure-your-server/secure-your-boot-drive.mdx) para obtener orientación sobre copias de seguridad.
+Antes de instalar, considera realizar una copia de seguridad de tu dispositivo de arranque para proteger tu configuración. Consulta [Asegura tu dispositivo de arranque](../../system-administration/secure-your-server/secure-your-boot-drive.mdx) para obtener orientación sobre copias de seguridad.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx`
at line 55, Update the visible Spanish wording that currently says "Asegura tu
unidad flash" to match the new boot-device terminology used in the linked page
(secure-your-boot-drive.mdx): change the sentence/link label in
community-applications.mdx from "Asegura tu unidad flash" to "Asegura tu unidad
de arranque" (or "Asegura tu dispositivo de arranque" if that matches the linked
page wording) so the link text and surrounding sentence consistently reference
the boot device.
docs/unraid-os/system-administration/secure-your-server/secure-your-boot-drive.mdx (1)

34-34: Minor inconsistency: image alt text references "Flash backup".

The alt text "Select the Flash backup button" still uses the old "Flash" terminology. While the image file path (/img/flashbackup.png) may remain unchanged, consider updating the alt text for consistency.

Suggested fix
-  ![Select the Flash backup button](/img/flashbackup.png)
+  ![Select the Boot Device Backup button](/img/flashbackup.png)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/unraid-os/system-administration/secure-your-server/secure-your-boot-drive.mdx`
at line 34, The image alt text "Select the Flash backup button" is using the old
"Flash" terminology; update that alt text to use the current terminology used
elsewhere in the docs (replace "Flash" with the preferred term) for the markdown
image referencing /img/flashbackup.png so the alt string matches the rest of the
content and accessibility labels.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@docs/unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx`:
- Line 21: Update the heading text in the target document so the link targets
match terminology used elsewhere: locate the heading currently written as "###
Backing up your flash device" and change it to "### Backing up your boot device"
(so links from upgrading-unraid.mdx that point to Backing up your boot device
resolve correctly); ensure the heading punctuation and spacing remain consistent
and no other heading IDs are altered.

In `@docs/unraid-os/troubleshooting/faq.mdx`:
- Around line 272-273: The second line currently uses a double-dash continuation
("-- Always [back up your boot device]...") instead of a Markdown list item;
replace the leading "--" with a single hyphen and a space to make it a proper
bullet point (i.e., change "-- Always ..." to "- Always ...") so the note
becomes a consistent Markdown list item in the FAQ section.

In
`@i18n/de/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`:
- Line 268: The list item "Ab Unraid OS 6.9 beginnt Partition 1..." contains a
literal "\n  --" which breaks Markdown; edit that text to remove the escape
sequence and render the note correctly by placing the dash-started sentence on
its own line (e.g., end the previous sentence, add a real newline, then start
"-- Sichern Sie immer [Ihr Flash-Laufwerk]..." or convert it into a proper
sub-list or sentence), updating the string in the MDX so the note list renders
properly.

In
`@i18n/es/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`:
- Line 272: The line beginning with the literal "\-- Siempre [respalda tu unidad
flash]..." should be converted to a proper markdown list bullet; locate the
malformed string ("\-- Siempre [respalda tu unidad
flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups)
antes de comenzar este proceso de conversión.") and replace the leading "\--"
with "- " so it renders as a bullet ("- Siempre ...") in the FAQ.

In
`@i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`:
- Line 272: The sentence "À partir d'Unraid OS 6.9..." contains a literal "\n"
and a double hyphen; remove the "\n", split the content into two real lines so
the warning appears on the following paragraph, and replace the double hyphen
("--") with a proper em-dash ("—") and correct spacing per French typographic
rules; locate and update the exact sentence in the FAQ content block in
unraid-os/troubleshooting/faq.mdx to apply these changes.

---

Nitpick comments:
In
`@docs/unraid-os/system-administration/maintain-and-update/partials/backup-using-webgui.mdx`:
- Around line 4-6: Update the image alt text to use the new terminology: replace
the current alt text "Flash Backup" in the JSX img element (the node rendering
![Flash Backup](/img/flashbackup.png)) with "Boot Device Backup" so the alt
attribute and any visible description match the updated wording across the docs.
- Around line 1-2: Clarify what the downloaded ZIP from the "Boot Device Backup"
step contains and how it is used: update the text near the "Boot Device" / "Boot
Device Backup" steps to add a short clause stating the ZIP contains the full
Unraid OS and configuration and can be used to recreate the USB by selecting
"Use custom" in the USB Flash Creator (so readers know it's restorable for
replacement workflows).

In
`@docs/unraid-os/system-administration/secure-your-server/secure-your-boot-drive.mdx`:
- Line 34: The image alt text "Select the Flash backup button" is using the old
"Flash" terminology; update that alt text to use the current terminology used
elsewhere in the docs (replace "Flash" with the preferred term) for the markdown
image referencing /img/flashbackup.png so the alt string matches the rest of the
content and accessibility labels.

In `@docs/unraid-os/troubleshooting/common-issues/data-recovery.mdx`:
- Line 225: Update the documentation text that refers to the Unraid
configuration file so the path is absolute: change the referenced
`config/super.dat` string to `/config/super.dat` wherever it appears in the
paragraph about losing your %%array|array%% configuration (specifically in the
sentence that mentions "located at `config/super.dat` on your boot device") to
make clear it is a root-relative path on the boot device; keep the surrounding
wording intact.

In
`@i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx`:
- Line 55: Update the visible Spanish wording that currently says "Asegura tu
unidad flash" to match the new boot-device terminology used in the linked page
(secure-your-boot-drive.mdx): change the sentence/link label in
community-applications.mdx from "Asegura tu unidad flash" to "Asegura tu unidad
de arranque" (or "Asegura tu dispositivo de arranque" if that matches the linked
page wording) so the link text and surrounding sentence consistently reference
the boot device.

In
`@i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx`:
- Line 55: Update the link label and surrounding sentence to use the boot-device
terminology instead of "clé USB": replace the visible text "Sécurisez votre clé
USB" (and the preceding "votre clé USB" in the sentence) with "Sécurisez votre
périphérique de démarrage" so the anchor text and sentence match the destination
page's terminology while keeping the existing URL.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: f4b161a2-ed89-45fe-8135-62b676ec1dc4

📥 Commits

Reviewing files that changed from the base of the PR and between 72ab6c9 and 77c06df.

📒 Files selected for processing (37)
  • docs/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • docs/unraid-os/getting-started/set-up-unraid/complete-your-post-setup-essentials.mdx
  • docs/unraid-os/getting-started/set-up-unraid/configure-your-array.mdx
  • docs/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • docs/unraid-os/getting-started/what-is-unraid.mdx
  • docs/unraid-os/release-notes/7.3.0.md
  • docs/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • docs/unraid-os/system-administration/advanced-tools/wake-on-lan.mdx
  • docs/unraid-os/system-administration/maintain-and-update/partials/backup-using-webgui.mdx
  • docs/unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx
  • docs/unraid-os/system-administration/secure-your-server/secure-your-boot-drive.mdx
  • docs/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • docs/unraid-os/system-administration/secure-your-server/wireguard.mdx
  • docs/unraid-os/troubleshooting/common-issues/data-recovery.mdx
  • docs/unraid-os/troubleshooting/common-issues/docker-troubleshooting.mdx
  • docs/unraid-os/troubleshooting/common-issues/partials/unclean-shutdowns/flash-drive-failure.mdx
  • docs/unraid-os/troubleshooting/common-issues/unclean-shutdowns.mdx
  • docs/unraid-os/troubleshooting/diagnostics/capture-diagnostics-and-logs.mdx
  • docs/unraid-os/troubleshooting/diagnostics/partials/syslog-server/local.mdx
  • docs/unraid-os/troubleshooting/diagnostics/partials/syslog-server/mirror.mdx
  • docs/unraid-os/troubleshooting/faq.mdx
  • docs/unraid-os/troubleshooting/licensing-faq.mdx
  • docs/unraid-os/troubleshooting/partials/licensing-faq/manual-keyfile-offline.mdx
  • docs/unraid-os/using-unraid-to/manage-storage/array/array-health-and-maintenance.mdx
  • docs/unraid-os/using-unraid-to/manage-storage/shares.mdx
  • docs/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • docs/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • docusaurus.config.ts
  • glossary.yaml
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
✅ Files skipped from review due to trivial changes (8)
  • docs/unraid-os/troubleshooting/common-issues/docker-troubleshooting.mdx
  • docs/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • docs/unraid-os/using-unraid-to/run-docker-containers/community-applications.mdx
  • docs/unraid-os/troubleshooting/diagnostics/partials/syslog-server/local.mdx
  • docs/unraid-os/getting-started/set-up-unraid/configure-your-array.mdx
  • docs/unraid-os/system-administration/secure-your-server/wireguard.mdx
  • docs/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx

:::note[Prerequisites]

Before you start upgrading, make sure to create a complete backup of your USB flash device. For more details, refer to [Backing up your flash device](../maintain-and-update/changing-the-flash-device.mdx#backing-up-your-flash-device).
Before you start upgrading, make sure to create a complete backup of your boot device. For more details, refer to [Backing up your boot device](../maintain-and-update/changing-the-flash-device.mdx#backing-up-your-flash-device).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check if the target anchor exists in the referenced file
echo "=== Checking anchor in target file ==="
rg -n "backing-up-your-flash-device|backing-up-your-boot-device" --glob "changing-the-flash-device.mdx"

echo ""
echo "=== Looking for heading that would generate the anchor ==="
rg -n -i "backing up your (flash|boot) device" --glob "changing-the-flash-device.mdx"

Repository: unraid/docs

Length of output: 1077


🏁 Script executed:

#!/bin/bash
# Check the content around lines 21 and 144 in upgrading-unraid.mdx
echo "=== Content around line 21 ==="
sed -n '19,23p' docs/unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx

echo ""
echo "=== Content around line 144 ==="
sed -n '142,146p' docs/unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx

echo ""
echo "=== Target heading in changing-the-flash-device.mdx ==="
sed -n '79p' docs/unraid-os/system-administration/maintain-and-update/changing-the-flash-device.mdx

Repository: unraid/docs

Length of output: 826


Update the target heading to align with boot device terminology.

Lines 21 and 144 link to "Backing up your boot device" but the target heading in changing-the-flash-device.mdx line 79 still reads "### Backing up your flash device". Update the target heading to "### Backing up your boot device" for terminology consistency across the documentation.

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

In
`@docs/unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx`
at line 21, Update the heading text in the target document so the link targets
match terminology used elsewhere: locate the heading currently written as "###
Backing up your flash device" and change it to "### Backing up your boot device"
(so links from upgrading-unraid.mdx that point to Backing up your boot device
resolve correctly); ensure the heading punctuation and spacing remain consistent
and no other heading IDs are altered.

Comment on lines 272 to +273
- Starting with Unraid OS 6.9, partition 1 starts at 32KiB for rotational devices and 1MiB for non-rotational devices, regardless of the partition style.
-- Always [back up your flash drive](../system-administration/secure-your-server/secure-your-flash-drive.mdx#backups) before starting this conversion process.
-- Always [back up your boot device](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) before starting this conversion process.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Formatting issue: double dash should be a bullet point.

Line 273 starts with -- which appears to be a continuation note that should be a proper bullet point for consistent markdown formatting.

Proposed fix
 - Starting with Unraid OS 6.9, partition 1 starts at 32KiB for rotational devices and 1MiB for non-rotational devices, regardless of the partition style.
-  -- Always [back up your boot device](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) before starting this conversion process.
+- Always [back up your boot device](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) before starting this conversion process.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/unraid-os/troubleshooting/faq.mdx` around lines 272 - 273, The second
line currently uses a double-dash continuation ("-- Always [back up your boot
device]...") instead of a Markdown list item; replace the leading "--" with a
single hyphen and a space to make it a proper bullet point (i.e., change "--
Always ..." to "- Always ...") so the note becomes a consistent Markdown list
item in the FAQ section.

- **Größer als 2TB**: Verwendet immer GPT-Partitionierung

- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.\n -- Sichern Sie immer [Ihr Flash-Laufwerk](../system-administration/secure-your-server/secure-your-flash-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.\n -- Sichern Sie immer [Ihr Flash-Laufwerk](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix malformed Markdown in the note list item.

Line 268 includes a literal \n --, which can render incorrectly and break list formatting.

Proposed markdown fix
-- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.\n  -- Sichern Sie immer [Ihr Flash-Laufwerk](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
+- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.
+- Sichern Sie immer [Ihr Boot-Gerät](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.\n -- Sichern Sie immer [Ihr Flash-Laufwerk](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
- Ab Unraid OS 6.9 beginnt Partition 1 bei 32 KiB für rotierende Geräte und 1 MiB für nicht rotierende Geräte, unabhängig vom Partitionsstil.
- Sichern Sie immer [Ihr Boot-Gerät](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups), bevor Sie diesen Konvertierungsprozess starten.
🧰 Tools
🪛 LanguageTool

[grammar] ~268-~268: Wähle ein passenderes Wort
Context: ...e Geräte, unabhängig vom Partitionsstil.\n -- Sichern Sie immer [Ihr Flash-Laufwerk](...

(QB_NEW_DE_OTHER_ERROR_IDS_REPLACEMENT_NOUN)

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

In
`@i18n/de/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`
at line 268, The list item "Ab Unraid OS 6.9 beginnt Partition 1..." contains a
literal "\n  --" which breaks Markdown; edit that text to remove the escape
sequence and render the note correctly by placing the dash-started sentence on
its own line (e.g., end the previous sentence, add a real newline, then start
"-- Sichern Sie immer [Ihr Flash-Laufwerk]..." or convert it into a proper
sub-list or sentence), updating the string in the MDX so the note list renders
properly.


- A partir de Unraid OS 6.9, la partición 1 comienza a las 32KiB para dispositivos rotacionales y a las 1MiB para dispositivos no rotacionales, independientemente del estilo de partición.
\-- Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-flash-drive.mdx#backups) antes de comenzar este proceso de conversión.
\-- Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) antes de comenzar este proceso de conversión.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix malformed bullet syntax in the backup reminder.

Line 272 starts with \--, which renders as literal text instead of a list bullet.

✏️ Proposed fix
-  \-- Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) antes de comenzar este proceso de conversión.
+  - Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) antes de comenzar este proceso de conversión.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
\-- Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) antes de comenzar este proceso de conversión.
- Siempre [respalda tu unidad flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) antes de comenzar este proceso de conversión.
🧰 Tools
🪛 LanguageTool

[grammar] ~272-~272: Aquí puede haber un error.
Context: ...endientemente del estilo de partición. -- Siempre [respalda tu unidad flash](.....

(QB_NEW_ES)

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

In
`@i18n/es/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`
at line 272, The line beginning with the literal "\-- Siempre [respalda tu
unidad flash]..." should be converted to a proper markdown list bullet; locate
the malformed string ("\-- Siempre [respalda tu unidad
flash](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups)
antes de comenzar este proceso de conversión.") and replace the leading "\--"
with "- " so it renders as a bullet ("- Siempre ...") in the FAQ.

- **Plus grand que 2 To** : Utilise toujours un partitionnement GPT

- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.\n -- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-flash-drive.mdx#backups) avant de commencer ce processus de conversion.
- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.\n -- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) avant de commencer ce processus de conversion.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Formatting issue: malformed newline escape and typographical dash.

This line contains what appears to be a literal \n string and improper dash formatting. The content should be on separate lines, and the double hyphen (--) should be an em-dash () per French typographical conventions.

Proposed fix
-- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.\n  -- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) avant de commencer ce processus de conversion.
+- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.
+- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) avant de commencer ce processus de conversion.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.\n -- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) avant de commencer ce processus de conversion.
- À partir d'Unraid OS 6.9, la partition 1 commence à 32KiB pour les dispositifs rotatifs et à 1MiB pour les dispositifs non rotatifs, quel que soit le style de partition.
- Toujours [sauvegarder votre clé USB](../system-administration/secure-your-server/secure-your-boot-drive.mdx#backups) avant de commencer ce processus de conversion.
🧰 Tools
🪛 LanguageTool

[typographical] ~272-~272: Ces deux traits d’union peuvent être associés pour former un tiret.
Context: ...quel que soit le style de partition.\n -- Toujours [sauvegarder votre clé USB](.....

(TIRET)

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

In
`@i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/troubleshooting/faq.mdx`
at line 272, The sentence "À partir d'Unraid OS 6.9..." contains a literal "\n"
and a double hyphen; remove the "\n", split the content into two real lines so
the warning appears on the following paragraph, and replace the double hyphen
("--") with a proper em-dash ("—") and correct spacing per French typographic
rules; locate and update the exact sentence in the FAQ content block in
unraid-os/troubleshooting/faq.mdx to apply these changes.

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