-
-
Notifications
You must be signed in to change notification settings - Fork 3.8k
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
[Guide] Embeds guide #9708
base: master
Are you sure you want to change the base?
[Guide] Embeds guide #9708
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.
review~
some general feedback pertaining to the whole guide:
overall, i think the structure and flow of the guide could improve a lot. i dont like how each field is introduced individually. i feel the guide should go over the basics:
- passing fields to the constructor
- alternatively using the setters
set_x
andadd_field
- nuances like attaching a file, library casting to
str
- a restrictions and limits section
- recipes with some cool looking embeds and a tip about ZWS
and then leave room for readers to experiment with other fields themselves.
i feel theres also way too many screenshots
i wanted to touch on a few other stuff as well but im a bit tired for now.
thanks for your work, feel free to ignore any advice etc. etc.
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.
Some nitpicks on layout and english
Co-Authored-By: Tom <[email protected]>
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.
Nicely done and well thought out, just one (or two) queries.
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.
From a first glance, there isn't much that I can point out. Nicely done.
~~~~~~~~~~~~~~~~~ | ||
|
||
Each field has its own character limit. Unfortunately, listing all the limits here would quickly become | ||
outdated, but you can find them in the :ddocs:`Discord API documentation<resources/channel#embed-object>`. |
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.
outdated, but you can find them in the :ddocs:`Discord API documentation<resources/channel#embed-object>`. | |
outdated, but you can find them in the :ddocs:`Discord API documentation<resources/channel#embed-object-embed-limits>`. |
The link supplied isn't the correct one as you would need to scroll down further, but this one should be the correct one: https://discord.com/developers/docs/resources/channel#embed-object-embed-limits
Summary
(This is continued from NCPlayz's PR at #7498)
Embeds guide.
Checklist