Update docs.json by lavanya-gunreddi · Pull Request #746 · runpod/docs

lavanya-gunreddi · 2026-07-29T15:54:59Z

No description provided.

mintlify · 2026-07-29T15:55:32Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
runpod-docs	🟢 Ready	View Preview	Sep 15, 2026, 12:46 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

murat-runpod · 2026-08-31T19:20:51Z

+
+## Limitations
+
+Global volumes use object-backed storage, not a POSIX file system. Review the following before using global volumes in production.


not a POSIX file system -> not a fully POSIX compliant file system

@Promptless apply this comment

Done — updated to "not a fully POSIX compliant file system." Pushed to this branch in commit 4053e32.

murat-runpod · 2026-08-31T19:22:11Z

+Global volumes use object-backed storage, not a POSIX file system. Review the following before using global volumes in production.
+
+- **Not suitable for training writes:** Writing large volumes of data such as checkpoints, logs, and activations to a global volume during training is not supported. Use a network volume for workloads that write frequently.
+- **No POSIX semantics:** Global volumes do not support file locking, atomic rename, or hard links. Applications that depend on POSIX behavior may fail or produce unexpected results.


~~No POSIX semantics~~
-> Limited POSIX semantics

@Promptless Apply this comment

Done — the label now reads "Limited POSIX semantics." Pushed to this branch in commit 4053e32.

murat-runpod · 2026-08-31T19:22:29Z

+- **Not suitable for training writes:** Writing large volumes of data such as checkpoints, logs, and activations to a global volume during training is not supported. Use a network volume for workloads that write frequently.
+- **No POSIX semantics:** Global volumes do not support file locking, atomic rename, or hard links. Applications that depend on POSIX behavior may fail or produce unexpected results.
+- **No concurrent writes across Pods:** Multiple Pods writing to the same global volume concurrently can cause data corruption or overwrite conflicts. Use a network volume for shared mutable storage.
+- **Object consistency:** Reads reflect the state of the volume at mount time. Updates made to the volume after the Pod starts may not be immediately visible inside the container.


~~Object consistency~~ -> "Eventual consistency"

@Promptless apply this comment

Done — the label now reads "Eventual consistency." Pushed to this branch in commit 4053e32.

promptless · 2026-08-31T21:50:35Z

On it — applying the requested wording changes to storage/globalstore.mdx on this branch now. I'll follow up here once the updates are pushed.

lavanya-gunreddi · 2026-09-14T19:24:33Z

@Promptless can you do a final check if we have applied all the rules from promptless.md file and runpod style guide

promptless · 2026-09-14T19:25:52Z

On it — I'm reviewing the changes in this PR against the PROMPTLESS.md guidance and the Runpod style guide, and I'll follow up here with what I find.

promptless · 2026-09-14T19:29:23Z

Update: I've reviewed the current changes against the PROMPTLESS.md guidance and the Runpod style guide. Most rules are already applied, but I found a few style items that still need attention (an em dash, meta-description length, inconsistent capitalization of "Global Volumes," and a missing <Steps> component that sibling storage pages use). I'm confirming the details and will follow up with the specifics.

- Remove em dash in intro (split into two sentences) - Expand meta description to 110-160 char range (was 71) - Use lowercase generic term 'global volume(s)' in prose, matching 'network volume' convention

promptless · 2026-09-14T19:38:23Z

I checked this PR against both the PROMPTLESS.md guidance and the Runpod style guide. Here's the result.

Already passing: sentence-case headings, correct proper-noun casing (Runpod, Pods), bullets ending in periods, relative internal links, and the earlier reviewer requests to switch to /workspace-global (all applied in 5082c66). The docs.json nav entry is clean.

Fixed and pushed to this branch:

Removed an em dash from the intro paragraph (the style guide prohibits em dashes) and split it into two sentences.
Expanded the meta description from 71 to 145 characters to fall within the required 110–160 range.
Lowercased "global volume(s)" in prose where it was inconsistently title-cased, to match how the guide treats the generic term "network volume." UI labels like the Global volume storage-type option were left capitalized.

One optional item I did not change: the Create, Attach, and Migrate procedures use plain numbered lists rather than the Mintlify <Steps> component that the procedural pattern recommends, and there's no "Requirements" section. I left this as a judgment call — the sibling storage pages mix both styles and your reviewers already approved the structure — but flagging it in case you'd like to adopt <Steps> here for consistency.

Mount paths, UI labels, procedures, and technical claims were left unchanged.

murat-runpod · 2026-09-14T20:33:55Z

+Global volumes use object-backed storage, not a fully POSIX compliant file system. Review the following before using global volumes in production.
+
+- **One volume of each type per Pod:** Each Pod currently supports a maximum of one global volume and one network volume at a time.
+- **Not suitable for training writes:** Writing large volumes of data such as checkpoints, logs, and activations to a global volume during training is not supported. Use a network volume for workloads that write frequently.


Would rephrase:

Not suitable for training writes: Writing large volumes of data to a global volume during training is not recommended. Use a network volume for workloads that write frequently.

@Promptless work on this comment

daveseddon-runpod · 2026-09-14T20:51:34Z

+2. Run the following command from the Pod's **Console** tab:
+
+```bash
+rsync -avh /workspace/ /workspace-global/


Maybe more readable?

rsync --archive --verbose --human-readable /workspace/ /workspace-global/

@promtpless can you update the command like this :

rsync -avh /workspace/ /workspace-global/

Where:

-a : copies all files and subdirectories, preserving timestamps, permissions, and symlinks

-v : prints each file as it transfers

-h : displays file sizes in a human-readable format (KB, MB, GB)

Mintlify-Source: dashboard-editor

promptless · 2026-09-14T21:40:49Z

Thanks for the review request — Promptless is looking into the docs.json change on this PR and will follow up shortly.

promptless · 2026-09-14T21:42:41Z

Scoped the requested change — it's a small rephrase to one bullet on the storage/global volume page. Applying it on this branch now.

Apply reviewer feedback on PR #746: drop the checkpoints/logs/activations examples and soften 'is not supported' to 'is not recommended' in the Not suitable for training writes bullet on the Global volumes page.

- Created storage/globalstore.mdx Mintlify-Source: dashboard-editor

promptless · 2026-09-14T21:48:44Z

On PR #746, we applied Murat's suggested rewrite to the "Not suitable for training writes" bullet on the Global volumes page: it now reads "Writing large volumes of data to a global volume during training is not recommended. Use a network volume for workloads that write frequently." (dropping the checkpoints/logs/activations examples and changing "is not supported" to "is not recommended"). Pushed to branch lg-global-store-477 in commit 8865ec1.

Note: Dave Seddon's separate rsync readability comment (line 67) wasn't tagged for us and wasn't part of this request, so it's untouched — let us know if you'd like that applied too.

# Conflicts: # release-notes.mdx

Update docs.json

bc5d995

lavanya-gunreddi added 5 commits July 29, 2026 14:02

Create globalstore-quickstart.mdx

b4fd143

Create globalstore-quickstart.mdx

111a14d

Delete storage/storage/globalstore-quickstart.mdx

fbcfd72

Create globalstore.mdx

012395a

Update docs.json

b5fbd75

mintlify Bot deployed to staging July 29, 2026 18:18 View deployment

lavanya-gunreddi added 2 commits August 3, 2026 11:03

Update globalstore.mdx

c2b3f40

Delete storage/globalstore-quickstart.mdx

1f0e377

mintlify Bot deployed to staging August 3, 2026 15:04 View deployment

mintlify Bot deployed to staging August 3, 2026 15:05 View deployment

lavanya-gunreddi added 3 commits August 3, 2026 11:05

Update docs.json

e77a17a

Merge branch 'main' into lg-global-store-477

4b5ab2e

Update docs.json

b9b6111

mintlify Bot deployed to staging August 3, 2026 15:24 View deployment

Update globalstore.mdx

3a6aac1

mintlify Bot deployed to staging August 3, 2026 18:56 View deployment

Update globalstore.mdx

820c568

mintlify Bot deployed to staging August 3, 2026 18:59 View deployment

Update globalstore.mdx

2071664

mintlify Bot deployed to staging August 31, 2026 15:38 View deployment

Update globalstore.mdx

474c0c7

mintlify Bot deployed to staging August 31, 2026 16:06 View deployment

Update globalstore.mdx

aea9835

mintlify Bot deployed to staging August 31, 2026 16:22 View deployment

Update globalstore.mdx

e5be34e

mintlify Bot deployed to staging August 31, 2026 16:24 View deployment

murat-runpod requested changes Aug 31, 2026

View reviewed changes

docs(DOCS-477): apply style guide fixes to Global Volumes page

e2e0296

- Remove em dash in intro (split into two sentences) - Expand meta description to 110-160 char range (was 71) - Use lowercase generic term 'global volume(s)' in prose, matching 'network volume' convention

mintlify Bot deployed to staging September 14, 2026 19:37 View deployment

Rename globalstore.mdx to globalvolume.mdx

641b93e

mintlify Bot deployed to staging September 14, 2026 19:45 View deployment

murat-runpod requested changes Sep 14, 2026

View reviewed changes

Update docs.json

8f87667

mintlify Bot deployed to staging September 14, 2026 20:46 View deployment

daveseddon-runpod reviewed Sep 14, 2026

View reviewed changes

docs(DOCS-477): add Global Volumes release notes entry (Sept 15, 2026)

3d4208e

Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging September 14, 2026 20:54 View deployment

promptless Bot and others added 2 commits September 14, 2026 21:46

docs(DOCS-477): rephrase training-writes limitation per PR review

8865ec1

Apply reviewer feedback on PR #746: drop the checkpoints/logs/activations examples and soften 'is not supported' to 'is not recommended' in the Not suitable for training writes bullet on the Global volumes page.

Updated mintlify pages

cc979dc

- Created storage/globalstore.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging September 14, 2026 21:48 View deployment

Merge remote-tracking branch 'origin/main' into lg-global-store-477

d1ce21b

# Conflicts: # release-notes.mdx

mintlify Bot deployed to staging September 14, 2026 22:02 View deployment

Update globalstore.mdx

e938dc2

mintlify Bot deployed to staging September 15, 2026 12:43 View deployment

Update release-notes.mdx

c95688f

mintlify Bot deployed to staging September 15, 2026 12:46 View deployment

lavanya-gunreddi requested a review from murat-runpod September 15, 2026 16:41

murat-runpod approved these changes Sep 15, 2026

View reviewed changes

lavanya-gunreddi merged commit ceb7997 into main Sep 15, 2026
4 checks passed

lavanya-gunreddi deleted the lg-global-store-477 branch September 15, 2026 16:47


		## Limitations

		Global volumes use object-backed storage, not a POSIX file system. Review the following before using global volumes in production.

Conversation

lavanya-gunreddi commented Jul 29, 2026

Uh oh!

mintlify Bot commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

promptless Bot Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

promptless Bot Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

promptless Bot Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

promptless Bot commented Aug 31, 2026

Uh oh!

lavanya-gunreddi commented Sep 14, 2026

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

promptless Bot commented Sep 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mintlify Bot commented Jul 29, 2026 •

edited

Loading