@@ -18,6 +18,9 @@ The command allows you to combine a schema that is spread across many files, for
1818<Tabs.Tab >
1919
2020``` zed
21+ use import
22+ use partial
23+
2124import "./subjects.zed"
2225
2326partial view_partial {
@@ -64,6 +67,30 @@ There are three new pieces of syntax: [import statements](#import-statements), [
6467
6568## Breaking Changes
6669
70+ ### ` use import ` and ` use partial `
71+
72+ _ ` zed ` version v0.36.0_
73+
74+ As of v0.36.0, if you want to use ` import ` and ` partial ` syntax, you need to enable the corresponding ` use ` flags, which tell the compiler
75+ that ` import ` and ` partial ` are valid syntax:
76+
77+ ``` zed
78+ use import
79+ use partial
80+
81+ import "foo.zed"
82+ partial something {}
83+ ```
84+
85+ Note that the ` use ` flags are only required in a file that uses those keywords - imported files that don't use their own
86+ ` import ` or ` partial ` syntax don't need the flags, though it is not an error for them to be present.
87+
88+ ### New Keywords
89+
90+ _ ` zed ` version v0.27.0 -> v0.35.0_
91+
92+ <Callout >This is superseded by ` use import ` and ` use partial ` above.</Callout >
93+
6794The composable schema compiler has some breaking changes relative to the compiler used internally by SpiceDB on a ` WriteSchema ` call.
6895A new version of SpiceDB should not cause your schema to break.
6996However, the schema compiler introduces some new keywords (among other changes), which may result in a schema that can be
@@ -83,6 +110,8 @@ Import statements allow you to break down a schema along the lines of top-level
83110<Tabs.Tab >
84111
85112``` zed
113+ use import
114+
86115// An import keyword followed by a quoted relative filepath
87116import "./one.zed"
88117
@@ -135,6 +164,8 @@ It can contain relations, permissions, and partial references just like a `defin
135164must be referenced by a [ partial reference] ( #partial-references ) to show up in the compiled schema.
136165
137166``` zed
167+ use partial
168+
138169partial view_partial {
139170 ...some_other_partial
140171
@@ -157,6 +188,8 @@ or [python's dictionary unpacking](https://docs.python.org/3/reference/expressio
157188This syntax:
158189
159190``` zed
191+ use partial
192+
160193partial view_partial {
161194 relation viewer: user
162195 permission view = viewer
0 commit comments