Skip to content

docs(run): say a folder refuses a backref filter and a placement with .. - #701

Merged
aicayzer merged 2 commits into
mainfrom
docs/folder-settings-agree
Oct 31, 2026
Merged

aicayzer merged 2 commits into
mainfrom
docs/folder-settings-agree

Conversation

@aicayzer

Copy link
Copy Markdown
Contributor

Summary

A folder's settings can no longer hold a backref filter or a first_placement directory with a .. name: the server refuses both with validation_error. The Sync a folder page now says so. Follows withmarfa/marfa#2519; closes withmarfa/marfa#2485 together with it.

Changes

  • content/docs/run/sync-a-folder.mdx: one sentence on the backref refusal where the query is described, and one paragraph on the .. refusal where settings are changed.

Testing

  • pnpm exec vitest run: 709 tests pass, including the content lint.
  • Not run: a site build.

Notes for reviewers

  • The Folder catalog page is generated from marfa's type description, so its first_placement and query rows change through marfa and the next sync, not here.

Checklist

  • The title is a scoped Conventional Commit.
  • New behavior has a test that was seen failing first, or no test was needed and the reason is above.
  • Docs, comments and the contract still say what is true after this change.

@aicayzer
aicayzer marked this pull request as ready for review October 31, 2026 00:43
@aicayzer
aicayzer enabled auto-merge (squash) October 31, 2026 00:43
@aicayzer
aicayzer merged commit 02b9add into main Oct 31, 2026
3 checks passed
@aicayzer
aicayzer deleted the docs/folder-settings-agree branch October 31, 2026 00:44
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.

The server and a device agree on which settings a folder can hold

1 participant