-
Notifications
You must be signed in to change notification settings - Fork 45
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add docs on ownership #371
Conversation
Also generate docs for function parameters.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall seems good to me! I am wondering about whether the with
and without
ownership terminology is a bit confusing, but I'm not sure if I have a necessarily better proposal.
"description": "Ownership of the value", | ||
"enum": [ | ||
"with", | ||
"without" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some bikeshedding... with
and without
feel a bit implicit? What if we used something more explicit like application
vs api
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Whoops I shouldn't have enabled automerge. Was thinking of that too, but used "With" and "Without" to match the ownership article. Maybe with_ownership: boolean
?
Also generate docs for function parameters.
I think these are the last of the docs for #143 and #326. I probably missed a few places that need ownership docs but this should be most of them.