Update/remove/replace the pinned message about slash commands in the #discord-bots channel
lxnn opened this issue · 8 comments
Amendment type
Content Update
Content type
Pinned Message
Please provide the location of the content
https://discord.com/channels/267624335836053506/343944376055103488/790795956115341322
What amendment do you think should be made to this content, and why?
A couple of members have reported that the information contained is not up-to-date and relevant. It was written at the start of 2021, and the landscape has changed a bit since then, most notably the ceasing of development of the discord.py library.
If you have any suggestions how the message could be changed or what it could be replaced with, please comment below.
We should obviously include the forks, such as Disnake or the other prominent ones that support slash commands, and also an example on how to use them in those forks, if it doesn't exceed the message length
There is also a package written by a Helper on the discord.py server, which adds slash commands functionality with discord.py 2.0.0a. This could be mentioned if someone doesn't wasn't to migrate to a while new fork.
We discussed this in our staff meeting last week, and we are leaning towards something like this:
- very brief articles of information can be documented on our site repo, for which adding content is fairly straightforward (adding markdown files)
- a pinned post in #discord-bots (or on other channels in the server) which will link to these articles
- possibly add tags with abbreviated content and link to said articles
What this solves:
- don't need to chase down members of the server to update pinned messages
What we want to avoid:
- too much burden or overhead for the maintenance of evolving content and tech
@Shom770 will be project lead of moving pinned #discord-bots content to pages on our site, and coordinating any content updates as needed.
I believe this can be closed now as discord.py is back in business. Thoughts if this is still relevant?
Most of the work has now been moved to python-discord/site#695
@Robin5605 Is there currently a PR open for a slash command-related article or resource in our site guides?
Now that it's been a while since application command support has been supported by discord.py, Application Command Basics and Application Command definition examples, both by AbstractUmbra, are great resources on this topic
We should also include the official documentation and examples in the resource.
I believe making a site page is not necessary for this, and making a short tag that links all of these resources should suffice.
A short tag with links sounds ok to me