-
Notifications
You must be signed in to change notification settings - Fork 17
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
Opt in documentation #28
base: master
Are you sure you want to change the base?
Conversation
…update an example
…gs (and soonto be misc) files
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.
Looks good, but directive is applied to attributes that are not part of the opt-in.
display_asset_path: Optional[:class:`str`] | ||
The display asset path of this entry. | ||
|
||
.. opt-in:: INCLUDE_PATHS |
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.
This field isn't affected by opt-in params.
gameplay_tags: List[:class:`str`] | ||
The gameplay tags for the playlist. | ||
|
||
.. opt-in:: INCLUDE_GAMEPLAY_TAGS | ||
path: :class:`str` | ||
The path of the playlist. | ||
|
||
.. opt-in:: INCLUDE_PATHS |
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.
Both fields are not affected by opt-in params.
docs/response_flags.rst
Outdated
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.
I think we should emphasize the user to only use the required opt-in parameters they actually need. And how the user benefits from it. (e.g. perfomance, bandwith)
display_asset_path: Optional[:class:`str`] | ||
The display asset path of the cosmetic, if available. | ||
|
||
.. opt-in:: INCLUDE_PATHS |
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.
This attribute seems to not present anymore. I need to check back with Officer about it's status.
Summary
This PR updates documentation to include information regarding the newly added
ResponseFlags
class in the library.response_flags
parameter in the client.Response Flags
section in the documentation describing what response flags are and how to use them... opt-in
sphinx directive that marks an attribute as needing to be marked-in.Checklist