Skip to content

Document structural root path semantics. - #76

Merged
samuel-williams-shopify merged 1 commit into
mainfrom
document-path-root-semantics
Aug 16, 2026
Merged

Document structural root path semantics.#76
samuel-williams-shopify merged 1 commit into
mainfrom
document-path-root-semantics

Conversation

@samuel-williams-shopify

Copy link
Copy Markdown
Contributor

Summary

  • document paths as tree traversals where components are nodes and separators are edges
  • distinguish the structural root [""] from an explicitly separated root path ["", ""]
  • explain why both serialize as / while retaining different component and local-path semantics
  • preserve the useful root-boundary tests considered in Use a canonical root path representation. #70 without changing the representation

This follows the discussion in #70 and records the intended model to avoid conflating structural equality with serialized equality in future changes.

Testing

  • bundle exec sus test/utopia/path.rb
  • bundle exec rubocop lib/utopia/path.rb test/utopia/path.rb
  • bundle exec bake decode:index:coverage lib

Assisted-By: devx/cbdeae41-9308-4071-ad53-58cd92db2946
@samuel-williams-shopify
samuel-williams-shopify merged commit fc12e25 into main Aug 16, 2026
34 of 40 checks passed
@samuel-williams-shopify
samuel-williams-shopify deleted the document-path-root-semantics branch August 16, 2026 22:49
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