-
-
Notifications
You must be signed in to change notification settings - Fork 106
Documentation standardising #2348
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
base: master
Are you sure you want to change the base?
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.
Why do some of the set methods say "Add ... to the cache" and some say "Set ... in the cache"? Because they both imply different things and I feel this needs to be clarified.
|
|
||
| @abc.abstractmethod | ||
| def get_members_view_for_guild( | ||
| self, guild_id: snowflakes.Snowflakeish, / |
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.
Why does this use guild_id instead of guild?
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.
because it only takes Snowflakeish not SnowflakeishOr
Should be changed to guild: snowflakes.SnowflakeishOr[guilds.PartialGuild] imo
would need deprecation tho
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.
That's what I was thinking
Summary
An attempt at standardising the format of all docstrings
Checklist
noxand all the pipelines have passed.I have made unittests according to the code I have added/modified/deleted.Related issues
N/A