diff options
Diffstat (limited to 'docs/contrib.rst')
-rw-r--r-- | docs/contrib.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/contrib.rst b/docs/contrib.rst new file mode 100644 index 0000000..b9a2a01 --- /dev/null +++ b/docs/contrib.rst @@ -0,0 +1,25 @@ +.. _contrib: + +============= +click-contrib +============= + +As the userbase of Click grows, more and more major feature requests pop up in +Click's bugtracker. As reasonable as it may be for those features to be bundled +with Click instead of being a standalone project, many of those requested +features are either highly experimental or have unproven practical use, while +potentially being a burden to maintain. + +This is why click-contrib_ exists. The GitHub organization is a collection of +possibly experimental third-party packages whose featureset does not belong +into Click, but also a playground for major features that may be added to Click +in the future. It is also meant to coordinate and concentrate effort on writing +third-party extensions for Click, and to ease the effort of searching for such +extensions. In that sense it could be described as a low-maintenance +alternative to extension repositories of other frameworks. + +Please note that the quality and stability of those packages may be different +than what you expect from Click itself. While published under a common +organization, they are still projects separate from Click. + +.. _click-contrib: https://github.com/click-contrib/ |