Skip to content

Commit d06c310

Browse files
committed
fix(docs): restore source admonition blocks
- purpose: restore real admonition components in source storage docs that were flattened during the broader i18n structure cleanup - before: short tip and caution sections in cache pool guidance and the XFS repair partial were rendered as plain bold paragraphs instead of Docusaurus admonitions - problem: the change weakened visual emphasis and dropped important formatting like the explicit Maintenance Mode reference in the parity warning - change: convert the example and use-case callouts in cache-pools back to :::tip blocks and restore the XFS parity warning to a :::caution block - result: source docs keep the intended admonition styling while translation-side syntax repairs remain unchanged
1 parent 06e0b7d commit d06c310

2 files changed

Lines changed: 15 additions & 3 deletions

File tree

docs/unraid-os/using-unraid-to/manage-storage/cache-pools.mdx

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -273,7 +273,11 @@ Rebuilding can take some time, depending on the size of the disk and the current
273273

274274
Setting a minimum free space for your %%cache pool|cache-pool%% can provide better control over file placement, especially when dealing with large files like high-resolution videos. This setting helps Unraid know when to stop writing to the pool and start writing directly to the larger storage %%array|array%%, avoiding interruptions or data corruption.
275275

276-
**Example:** If you often download files around 10 GB, set the minimum free space to at least 10 GB, but ideally 20 GB to allow for adjustments.
276+
:::tip[Example]
277+
278+
If you often download files around 10 GB, set the minimum free space to at least 10 GB, but ideally 20 GB to allow for adjustments.
279+
280+
:::
277281

278282
You can access Minimum free space by clicking on the pool name in the **Main** tab and going to **Individual Pool Settings**.
279283

@@ -285,7 +289,11 @@ You can access Minimum free space by clicking on the pool name in the **Main** t
285289
- If set to use a %%cache pool|cache-pool%% exclusively (no **Secondary storage**), this setting is not applied.
286290
- If set to use only the %%array|array%% as **Primary storage**, files go straight to the %%array|array%%.
287291

288-
**Use case example:** Media share has the floor set to 20GB, which is appropriate for the files in that share. However, if you also use the pool for a VM and want to leave a cushion in case the vdisk grows, you could set the pool floor to 50GB. This way, any transfer to the Media share after the pool has less than 50GB free would go directly to the array.
292+
:::tip[Use case example]
293+
294+
Media share has the floor set to 20GB, which is appropriate for the files in that share. However, if you also use the pool for a VM and want to leave a cushion in case the vdisk grows, you could set the pool floor to 50GB. This way, any transfer to the Media share after the pool has less than 50GB free would go directly to the array.
295+
296+
:::
289297

290298
:::tip[Best practice]
291299

docs/unraid-os/using-unraid-to/manage-storage/partials/fs-repair-cli-xfs.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,8 @@
44
- If you're prompted to use `-L`, re-run the command like this: `xfs_repair -L /dev/mdXp1`. This is usually safe and necessary to complete the repair.
55
- For drives that are not part of the %%array|array%%: `xfs_repair /dev/sdX1`.
66

7-
**Caution:** Running this command on an %%array|array%% disk outside of maintenance mode will invalidate parity.
7+
:::caution
8+
9+
Running this command on an %%array|array%% disk outside of **%%Maintenance Mode|maintenance-mode%%** will invalidate parity.
10+
11+
:::

0 commit comments

Comments
 (0)