People who contribute to open-source projects could be spending their free time. It does not matter if it is a code change, an epic, or fixing a small typo. At the end of the day, this change makes the project better. That's the reason why you should recognize every contribution!
Are you using Sphinx to document the open-source project? Then sphinxcontrib-ghcontributors directive allows you to render all the usernames that have contributed to your repositories directly in your docs.
- Install sphinxcontrib-ghcontributors using pip.
pip install sphinxcontrib-ghcontributors
- Add the extension to your Sphinx project
conf.py
file.
extensions = ['sphinxcontrib.ghcontributors']
The extension defines the directive ghcontributors
. For each repository that you want to render its contributors, state the Github username and the repository name.
.. ghcontributors:: dgarcia360/sphinxcontrib-ghcontributors
Sphinx will render the 10 most active contributors. You can increase the number of results to show, and as well exclude some users from the list adding optional filters.
.. ghcontributors:: dgarcia360/sphinxcontrib-ghcontributors
:limit: 20
:order: ASC
:exclude: dgarcia360,sphinx
This directive will render the less active 20 contributors, ordered in ascending order, excluding dgarcia360
and sphinx
usernames from the list.
See the open issues for a list of proposed features.
Contributions are welcome and appreciated! Check CONTRIBUTING.md file.
Copyright (c) 2018 David Garcia (@dgarcia360).
Licensed under MIT license (see LICENSE.md for details)