You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/content/modeling/modular-models.mdx
+7-5
Original file line number
Diff line number
Diff line change
@@ -24,10 +24,12 @@ import {
24
24
25
25
<DocumentationNotice />
26
26
27
-
Modular models allows splitting your authorization module across multiple files and modules, improving upon some of the challenges that may be faced when operating an authorization model within a company, such as:
27
+
Authorization is application-specific. In an organization with multiple teams building different applications or modules, each team should be able to define and evolve their authorization policies independently.
28
28
29
-
- A model can grow large and difficult to understand
30
-
- As more teams begin to contribute to a model, the ownership boundaries may not be clear and code review processes might not scale
29
+
Modular models allows splitting your authorization model across multiple files and modules, improving upon some of the challenges that may be faced when maintaining an authorization model within a company, such as:
30
+
31
+
- A model can grow large and difficult to understand.
32
+
- As more teams begin to contribute to a model, the ownership boundaries may not be clear and code review processes might not scale.
31
33
32
34
With modular models, a single model can be split across multiple files in a project. It can be organized in a way that makes sense for the project or teams collaborating on it, and it enables ownership for reviews to be expressed using a feature such as [GitHub's](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners), [GitLab's](https://docs.gitlab.com/ee/user/project/codeowners/) or [Gitea's](https://docs.gitea.com/usage/code-owners) code owners.
33
35
@@ -44,9 +46,9 @@ The `fga.mod` is the project file for modular models. This file specifies the sc
44
46
45
47
### Modules
46
48
47
-
Modules are declared using the `module` keyword in the DSL, and a module can be written across multiple files. A single file cannot have more than one module.
49
+
<ProductNameformat={ProductNameFormat.ShortForm}/> modules define the types and relations for a specific application module or service.
48
50
49
-
Currently, modules are stored as metadata but are not used by <ProductNameformat={ProductNameFormat.ShortForm}/>. Module metadata will be used in upcoming features, such as applying authorization to writing and reading/querying tuples.
51
+
Modules are declared using the `module` keyword in the DSL, and a module can be written across multiple files. A single file cannot have more than one module.
0 commit comments