Extension Guidelines

[Soheab]

Summary

Guidelines for second/third-party extensions

What is the feature request for?

The documentation

The Problem

From what I can understand, the discord/ext namespace is open for users to "inject" their addons to the library for things that are potentially missing or something else but I can't seem to find any guidelines on what such extension should follow. Like best practices, do's and don'ts, etc.

The Ideal Solution

Provide / Write guidelines for using the discord/ext namespace. Some things I can think of are as follows:

• Typing, should extensions be typed to comply to maintain quality etc...
• Exceptions, should extensions provide a base exception to handle all errors etc...
• Import from library, what can extensions import from the main lib (discord/...) and what not etc...
• etc...

The Current Solution

You can ask around / regulars/contributors in the discord.py server. I guess.

Additional Context

No response

[EvieePy]

As far as guidelines around all the things mentioned, I don't think it would be appropriate to set rules on how people develop their software. Third-Party extensions are not official and are created by members of the community; they are used much like any other installable python package, for the most part. Typing, exceptions etc etc are all responsibilities and choices made by the creators, and it's up to the end user to decide whether they want to use these extensions or not.

[Soheab]

As far as guidelines around all the things mentioned, I don't think it would be appropriate to set rules on how people develop their software. Third-Party extensions are not official and are created by members of the community; they are used much like any other installable python package, for the most part. Typing, exceptions etc etc are all responsibilities and choices made by the creators, and it's up to the end user to decide whether they want to use these extensions or not.

That is fair, but I think of it as a PEP8 kind of thing where creators can follow it but are not forced to. The library provides the ability and I think it's only good to also provide some sort of good practices guide for it. I do agree that my example points are kind of silly now that I think about it.

The guide could potentially also be used to differentiate between good and bad extensions and maybe recommend them on the server or showcase them somewhere instead of shitting on them (I know, a guide isn't going to help with that).