docs(FR-3455): update Storage Folders chapter for 26.8

[yomybaby]

Resolves #8548 (FR-3455)

⚠️ Both screenshots were captured with mocked folder data

Why: the capture server holds zero storage folders — verified via /data, /admin/data (superadmin, system-wide) and backendaiclient.vfolder.list() returning []. It was reset 2026-08-03 12:05Z. An empty folder table would have contradicted the prose directly above the image ("folder name and ID, the storage host name, folder access rights"), and no mixed deletable/non-deletable selection could exist at all.

What was mocked: exactly one GraphQL operation, VFolderNodeListPageQuery, via the project's setupGraphQLMocks (client-side page.route; read-only). Every other operation and all REST traffic passed through untouched. The response shape was built from the generated normalization AST in react/src/__generated__/VFolderNodeListPageQuery.graphql.ts, not guessed.

Eight fictional folders, three of them deliberately without delete_vfolder permission so the exclusion alert has something to list:
training-data, shared-models, notebooks, imagenet-subset, team-datasets, llm-checkpoints, experiment-logs, .local-cache ( = no delete permission). Owner shows admin@lablup.com / project default, matching the logged-in demo admin already visible in the header — no real end-user emails, no production-looking IDs.

Nothing was created or deleted. The delete modal was closed via the X (onRequestClose(false)); onOk — the only path calling vfolder.delete_by_id — was never reached, and the OK button was never clicked in any locale. A dedicated guard test then logged in fresh with no mocks and asserted the real list still reports 0 - 0 of 0 items and that none of the eight mock names exist. That run passed.

Summary

Updates the Storage Folders chapter for 26.8 in all four languages (en/ko/ja/th), with both screenshots captured.

Part of the 26.8 user manual refresh (epic #8538 / FR-3445).

Attribution

Section	Driven by	Author
Delete-folder modal lists affected folders in an alert	FR-3257 #8162	@nowgnuesLee
Auto-refresh interval dropdown on the folder list	FR-3147 #7928	@agatha197
Label accuracy pass (Controls / Delete forever)	FR-3331 #8303	@ironAiken2

Reviewers are the driving authors minus the PR author (@yomybaby opened this PR).

Two triaged rows did not apply

Verified against source, and no prose was invented for either:

• FR-3011 — this chapter describes exactly one filter interaction, the Audit Log tab's, which is ScopedAuditLog.tsx with triggeredBy still type: 'string' free text. The Data page's own host filter is also still free text. FR-3011's typed-picker consumers are ModelStoreListPageV2, AdminModelCardListPage and the storage-host drawer panels — all admin_menu.md territory, updated there in FR-3446.
• FR-3331 — mostly non-applicable. No row action here is labelled "Edit"; folder rename uses antd inline editing, which FR-3331 explicitly left alone, and the file editor's Save/Cancel was excluded from that FR. It reduced to the label fixes below.

A spec-vs-reality correction

The issue describes the FR-3257 alert as collapsible. It is not. DeleteVFolderModal.tsx renders BAIListAlert — a bulleted list that scrolls past maxHeight: 165. And the folders it lists are the excluded ones (no delete_vfolder permission), not the ones being deleted; the confirmation sentence separately counts only the deletable remainder. The prose follows the code, not the issue wording — and the screenshot shows exactly that: 5 selected, 2 listed as excluded, 3 counted for deletion.

Screenshots

Image	Scope	Status
data_page.png	full page	✅ recaptured, mocked list
vfolder_bulk_move_to_trash.png	dialog element	✅ new, mocked list

Framing preflight: data_page.png was 2880x1800 full-page and remains 2880x1800 — identical scope, differing only in content (8 folders, and the refresh control is now the split button with the Auto Refresh chevron). Output was byte-reproducible across three runs, a decent signal there was no render race.

Each locale booted from scratch rather than in-place switchLanguage(), with the English strings asserted to have count 0 per non-en locale.

Two residual English fragments are the app's own untranslated i18n, not capture staleness: the READY status tag (an enum shown verbatim in every locale) and ja's 1 - 8 of 8アイテム pagination string.

A maintainability caveat worth knowing

The mocked images depict folders that exist on no real system, and the mock data lived only in the capture spec, which was deleted after the run — so these images cannot be regenerated by simply re-running against the server later. The full folder table is preserved in the capture commit message. This applies to every mocked capture in this refresh; see the note in the epic (#8538) about whether the capture specs should be committed under e2e/ for reproducibility.

Verification

All three docs-checks.yml steps green: check:terminology-md, check:nav-titles (112 entries), check-terminology-i18n.mjs --strict (0 blocking / 0 warn).

Label drift fixed

• en: "Control column" → Controls (comp:FileExplorer.Controls)
• en: Delete Forever → Delete forever (data.folders.DeleteForever)
• ja: 完全に削除 → 永久に削除 (ko 영구 삭제 and th ลบถาวร already matched)

Noted, not fixed

The delete section says the restore button is in the "Control column", but the row actions actually live in the Name cell (BAINameActionCell). Pre-existing drift, outside this update's rows.

🤖 Generated with Claude Code

Copy revision (2026-08-04, review round)

Reviewed the ko chapter with 홍성철 and applied the confirmed edits:

• Refresh section (all 4 langs): simplified to two sentences (refresh button + auto-refresh interval via the dropdown arrow); dropped the interval enumeration, check-mark note, and the countdown/persistence paragraphs. "Chevron" wording removed.
• Audit log tab (all 4 langs): removed the paragraph re-describing the auto-refresh button.
• Bulk move-to-trash (all 4 langs): reworded the exclusion-alert paragraph ("check the list before proceeding with the deletion"; the count reflects folders actually moved) and dropped the scroll-behavior sentence. The quoted alert title stays byte-identical to each locale's ExcludedFolders i18n label.
• ko only: full-chapter prose pass removing translationese (overused "~할 수 있습니다" endings, heavy pre-modifiers, commas after connective endings, "권한을 가지고 있는 경우" → "권한이 있으면", repeated "~를 통해"). Structure, UI labels, quotes, anchors, and technical values verified unchanged; en/ja/th intentionally left as-is for this pass.

[Copilot]

Pull request overview

Updates the Storage Folders manual for Backend.AI 26.8 across four languages.

Changes:

• Documents auto-refresh controls and bulk folder deletion.
• Updates UI labels and screenshots.
• Improves Korean prose.

Reviewed changes

Copilot reviewed 4 out of 16 changed files in this pull request and generated 1 comment.

File	Description
src/en/vfolder/vfolder.md	Adds 26.8 behavior and label updates.
src/ko/vfolder/vfolder.md	Adds features and revises Korean prose.
src/ja/vfolder/vfolder.md	Adds features and corrects labels.
src/th/vfolder/vfolder.md	Adds auto-refresh and bulk deletion guidance.

[ironAiken2]

LGTM