Skip to content
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

feat: Added an explanation on reactions #55

Open
wants to merge 11 commits into
base: main
Choose a base branch
from

Conversation

Strixen
Copy link

@Strixen Strixen commented Jan 6, 2023

Description

The guide has several pages that are currently WIP.

I took the liberty to flesh out the Reactions portion.
Am a bit unsure how to target the guide however. Reactions and its usage is somewhat basic knowledge,
and very easy to glean usage from the api docs.
Therefore i took the approach that the person reading would be quite entry level with python.
This means explaining things that might seem obvious and using a lot of comments in the code snippet.

It mainly covers the on_raw_reaction events since they are probably the most useful.
But included a MessageCommand example to demonstrate working with the Reaction class since its kind of the main focus.
Truth be told there's not really that much to be said about Reactions, so added things i found useful when working with reactions on my projects.
Also includes a brief primer on how Emojis work seeing as they're pretty integral to Reactions and knowing how they are supplied is important to filter events correctly.

Includes links to other parts of the guide and github to reduce repeating information that needs to be maintained and agree with each other.

@shiftinv shiftinv added t: page/section addition Pull Request to add new content to the guide. s: needs review labels Jan 6, 2023
Copy link
Member

@shiftinv shiftinv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! I quite like the fact that the different emoji types are also explained, as well as the usage of raw events.
I've left a bunch of (mostly tiny) comments/suggestions - I tried to cleanly separate them, so it may seem more than it actually is. Hope I wasn't too pedantic :>

guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
Strixen and others added 7 commits January 7, 2023 07:53
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
These are good suggestions

Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
Merged the suggesions from Shiftinv and took their comments into consideration and made some alterations
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
LGTM

Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
Copy link
Member

@shiftinv shiftinv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few more formatting comments. I think that's everything now, thanks for enduring my comments so far 🙏

guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
guide/docs/popular-topics/reactions.mdx Outdated Show resolved Hide resolved
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>
Signed-off-by: Strix <thomhod@gmail.com>
@shiftinv shiftinv changed the base branch from dev to main January 8, 2023 14:54
Copy link
Member

@shiftinv shiftinv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

forgot to approve, my bad

Fixed some straggling spelling errors
Copy link
Member

@abhigyantrips abhigyantrips left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree with the content so far. Can you also create corresponding files under the examples/ directory? The location convention is a part of the contributing guide.

@@ -1,8 +1,314 @@
---
description: Create polls, paginate your commands, and more.
description: This section covers the topic of interacting with message reactions. Both adding them with code, and reacting to on_reaction events
hide_table_of_contents: true
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The TOC will be visible on non-WIP pages.

Suggested change
hide_table_of_contents: true

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
s: needs review t: page/section addition Pull Request to add new content to the guide.
Projects
Status: In Progress
Development

Successfully merging this pull request may close these issues.

None yet

3 participants