Skip to content

Conversation

@novanai
Copy link
Contributor

@novanai novanai commented May 3, 2025

Summary

An attempt at standardising the format of all docstrings

Checklist

  • I have run nox and all the pipelines have passed.
  • I have made unittests according to the code I have added/modified/deleted.

Related issues

N/A

@novanai novanai changed the title rewrite hikari.api.cache Documentation standardising May 3, 2025
Copy link
Contributor Author

@novanai novanai left a 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, /
Copy link
Contributor Author

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?

Copy link
Member

@rayakame rayakame May 3, 2025

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

Copy link
Contributor Author

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

@davfsa davfsa added documentation Improvements or additions to documentation breaking This change hurts backwards compatibility labels May 3, 2025
@github-project-automation github-project-automation bot moved this to Ready to review in hikari development May 3, 2025
@davfsa davfsa moved this from Ready to review to In progress in hikari development May 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking This change hurts backwards compatibility documentation Improvements or additions to documentation

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

3 participants