chore(docs): refine the "getting started with modeling" page - #656
chore(docs): refine the "getting started with modeling" page#656pavokta wants to merge 7 commits into
Conversation
This is a first-half edit of a very, very long document. I know that this is a lot to look over, so feel free to schedule me for a Zoom call so we can talk edits over before you merge.
|
| In a few cases other users can be part of determining whether an action can be performed on an action or not. Social media is an example of this "a user can comment on a picture if they are a friend of the user that published it". | ||
| Though you're in the process of building a version you can use, the model above is not yet a valid authorization model accepted by <ProductName format={ProductNameFormat.ShortForm}/>. | ||
|
|
||
| In a few cases, other users can determine whether one action can be performed on another action. For example, on social media, sometimes a user can comment on a picture if they are a friend of the user that published it. |
There was a problem hiding this comment.
I don't think this whole note is helpful here, let's remove it. It used to be back in back in the day where we didn't require a type for an object
| In a few cases, other users can determine whether one action can be performed on another action. For example, on social media, sometimes a user can comment on a picture if they are a friend of the user that published it. | ||
|
|
||
| In those cases [**User** should also be an object type](./building-blocks/object-to-object-relationships.mdx). Following the last recommendation, we would discover the User type because it is a second noun in an expression: "friend of the user". | ||
| In those cases [**User** must be an object type](./building-blocks/object-to-object-relationships.mdx), and you would discover the User type because it is a second noun in an expression `friend of the user`. |
Co-authored-by: Raghd Hamzeh <raghd.hamzeh@openfga.dev>
Co-authored-by: Raghd Hamzeh <raghd.hamzeh@openfga.dev>
Co-authored-by: Raghd Hamzeh <raghd.hamzeh@openfga.dev>
Co-authored-by: Raghd Hamzeh <raghd.hamzeh@openfga.dev>
Co-authored-by: Raghd Hamzeh <raghd.hamzeh@openfga.dev>
Change as specified at #656 (comment)
|
This PR has had no human activity for 90 days, so it has been marked This is automated backlog grooming, not a judgment on the work. What happens next, unless there is activity:
To keep it open, push a commit or leave a comment, and the clock will reset. For work that should not auto-close, such as an RFC or long-running experiment, ask a maintainer to add |
|
This PR has had no human activity for 30 days since being marked It will be closed in 30 days unless there is new activity. If the work still matters, this is the moment to say so: leave a comment, push a commit, or ask a maintainer to add If this work is no longer being pursued, no action is needed. |
This is a first-half edit of a very, very long document.
I know that this is a lot to look over, so feel free to schedule me for a Zoom call so we can talk edits over before you merge.
Description
References
Review Checklist
main