docs: Improve docstrings and attribute documentation#2754
Conversation
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
add missings docs Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
|
checklist might not be accurate, i changed the code to add some missings parts but its mainly adding the missing docs + parameters inside the function definition |
| overwrites: dict[Role | Member, PermissionOverwrite] = MISSING, | ||
| reason: str | None = None, | ||
| position: int = MISSING, | ||
| nsfw: bool = MISSING, |
There was a problem hiding this comment.
What happens really when a category is nsfw ? Is that inherited to the category's channels ?
There was a problem hiding this comment.
no idea, i guess yes
There was a problem hiding this comment.
There was a problem hiding this comment.
There was a problem hiding this comment.
even if i dont think it change anything so i'll remove it
| .. versionadded:: 2.0 | ||
|
|
||
| nsfw: :class:`bool` | ||
| To mark the channel as NSFW or not. |
There was a problem hiding this comment.
| To mark the channel as NSFW or not. | |
| Whether the channel is marked as NSFW or not. |
There was a problem hiding this comment.
for the nsfw docs, i copy them from their class to keep them similar
There was a problem hiding this comment.
Yeah but here it's not for editing the channel it's an attribute
|
Also, I assume you tested each of the changes and they work. + Add the changelog |
nop i didnt test them yet, i will do that this afternoon, i also have to fix another issue before the "'ForumChannel' object has no attribute 'default_reaction_emoji'" |
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
|
i tested it everything works, so this add the missing docstring and parameters for the channels and add the possibility to create a channel with a default reaction as None (edit was already done by paillait) |
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
removal of all the nsfw mention which should not exist for category Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
Signed-off-by: Lumabots <144063653+Lumabots@users.noreply.github.com>
|
i removed all of the nsfw code related to category channel since even if its returned by discord its not posible to be other thing than false |
|
ready for review |
|
Succeeded by #2772 |

Summary
Information
examples, ...).
Checklist
type: ignorecomments were used, a comment is also left explaining why.