Skip to content

Fill gaps from assistant conversations: nested hierarchy modeling#292

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/7e5f8656
Open

Fill gaps from assistant conversations: nested hierarchy modeling#292
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/7e5f8656

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify how to model nested product hierarchies with Velt when Locations are flat, and how to roll up activity across a hierarchy.

Changes

  • key-concepts/overview.mdx — Explicitly state Locations are flat (cannot be nested), and add a "Modeling nested hierarchies" subsection explaining how to combine Folders/subfolders, Documents, Locations with custom hierarchy fields, and cross-document activity rollups.
  • async-collaboration/activity/overview.mdx — Document the cross-document rollup pattern (passing multiple documentIds) and note that filtering by custom metadata must happen client-side after subscribing.

Context

Recent assistant conversations showed repeated confusion around whether Locations can be nested, how to represent multi-level entity trees (e.g. Style → Variant → SKU), and how to query or roll up activity across such a hierarchy. The APIs already support these patterns; the docs did not spell out the recommended shape.

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
velt 🟢 Ready View Preview Jul 20, 2026, 4:13 PM

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
velt 🟡 Building Jul 20, 2026, 4:09 PM

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.

0 participants