-
Notifications
You must be signed in to change notification settings - Fork 523
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
Attributes on functions #387
Conversation
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.
LGTM, though still blocked
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.
A couple of suggestions, but I'm OK with this as is.
src/items/functions.md
Outdated
|
||
Inner [attributes] on the function's block apply to the function item as a whole. | ||
Functions allow for [outer attributes][attributes] and for [inner | ||
attributes][attributes] where inner attributes are allowed on its [block]. |
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.
Make this two sentences?
"allowed on" => "written inside"?
src/items/functions.md
Outdated
|
||
For example, this function will only be available while running tests. | ||
For example of an inner attribute on a function, this function will only be | ||
available while running tests. |
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.
Maybe this is a result of reading this in raw markdown, but I wasn't expecting a code example after "For example of...". Perhaps "This example shows an ..., the function ..." would be clearer?
Both are good calls. I've improved the sentence flow around both. |
Thanks! |
This is blocked on #381 and #382 for correct links.
must_use
Attribute" section tomust_use
to match the "derive
" section further on in the page.cfg
attribute to the new conditional compilation page. Probably should have done this when movingcfg
to its own page. But doing it here where I'm adding a new link to it.