Docs: "Who is using it" section (#229)

Author: humitos

docs/conf.py

@@ -51,6 +51,7 @@
     'versionwarning.extension',
     'notfound.extension',
     'sphinxcontrib.bibtex',
+    'sphinxemoji.sphinxemoji',
 ]
 
 bibtex_bibfiles = ['refs.bib']

docs/crest-usage.gif

@@ -90,6 +90,7 @@ Badges:
    installation
    usage
    configuration
+   who-is-using-it
    development
    releasing
 

docs/disnake-usage.gif

@@ -10,7 +10,7 @@ astroid==2.12.9
     # via sphinx-autoapi
 babel==2.10.3
     # via sphinx
-certifi==2022.6.15.1
+certifi==2022.6.15.2
     # via requests
 charset-normalizer==2.1.1
     # via requests
@@ -23,7 +23,7 @@ docutils==0.17.1
     #   sphinx-rtd-theme
     #   sphinx-tabs
     #   sphinxcontrib-bibtex
-idna==3.3
+idna==3.4
     # via requests
 imagesize==1.4.1
     # via sphinx
@@ -80,6 +80,7 @@ sphinx==4.5.0
     #   sphinx-tabs
     #   sphinx-version-warning
     #   sphinxcontrib-bibtex
+    #   sphinxemoji
 sphinx-autoapi==1.9.0
     # via sphinx-hoverxref (pyproject.toml)
 sphinx-autobuild==2021.3.14
@@ -108,6 +109,8 @@ sphinxcontrib-qthelp==1.0.3
     # via sphinx
 sphinxcontrib-serializinghtml==1.1.5
     # via sphinx
+sphinxemoji==0.2.0
+    # via sphinx-hoverxref (pyproject.toml)
 tornado==6.2
     # via livereload
 unidecode==1.3.4

docs/hypothesis-usage.gif

@@ -0,0 +1,89 @@
+Who Is Using It?
+================
+
+These are some projects using this extension
+that you can take a look at to understand how they are configured and what's the behavior.
+
+Setuptools
+----------
+
+|:books:| Repository
+   https://github.com/pypa/setuptools/
+
+|:art:| Demo
+   .. image:: setuptools-usage.gif
+      :align: center
+      :width: 100%
+
+
+disnake
+-------
+
+|:books:| Repository
+   https://github.com/DisnakeDev/disnake/
+
+|:art:| Demo
+   .. image:: disnake-usage.gif
+      :align: center
+      :width: 100%
+
+
+returns
+-------
+
+|:books:| Repository
+   https://github.com/dry-python/returns
+
+|:art:| Demo
+   .. image:: returns-usage.gif
+      :align: center
+      :width: 100%
+
+
+scrapy
+------
+
+|:books:| Repository
+   https://github.com/scrapy/scrapy/
+
+|:art:| Demo
+   .. image:: scrapy-usage.gif
+      :align: center
+      :width: 100%
+
+
+tweepy
+------
+
+|:books:| Repository
+   https://github.com/tweepy/tweepy/
+
+|:art:| Demo
+   .. image:: tweepy-usage.gif
+      :align: center
+      :width: 100%
+
+
+
+hypothesis
+----------
+
+|:books:| Repository
+   https://github.com/HypothesisWorks/hypothesis
+
+|:art:| Demo
+   .. image:: hypothesis-usage.gif
+      :align: center
+      :width: 100%
+
+
+crest
+-----
+
+|:books:| Repository
+   https://github.com/wave-harmonic/crest
+
+|:art:| Demo
+   .. image:: crest-usage.gif
+      :align: center
+      :width: 100%

docs/index.rst

@@ -49,6 +49,7 @@ doc = [
     "sphinx-notfound-page",
     "sphinx-autobuild",
     "sphinxcontrib-bibtex",
+    "sphinxemoji",
 ]
 
 [project.urls]