|
3 | 3 | Contributing packages
|
4 | 4 | *********************
|
5 | 5 |
|
6 |
| - |
7 |
| -To submit a package to the ``conda-forge`` channel, add its ``recipe`` and licence to the ``staged-recipes`` repository and create a pull request. Once the pull request is merged, the package becomes available |
8 |
| -on the ``conda-forge`` channel. Note that contributing a package makes you the ``maintainer`` of that package. |
9 |
| - |
10 |
| -A maintainer is responsible for maintaining the feedstock repository and packages as well as their future versions and has push access to the feedstock repositories of only the packages it maintains. |
11 |
| -You can learn more about the roles of a maintainer `here. <https://conda-forge.org/docs/maintainer/adding_pkgs.html#maintainer-role>`__ |
| 6 | +To submit a package to the ``conda-forge`` channel, add its ``recipe`` and licence to the ``staged-recipes`` repository and create a pull request. Once the pull request is merged, the package becomes available on the ``conda-forge`` channel. |
12 | 7 |
|
13 | 8 | The sections below provide detailed instructions on contributing packages to conda-forge.
|
14 | 9 |
|
@@ -761,6 +756,38 @@ For some languages, the community provides tools which can automate this process
|
761 | 756 |
|
762 | 757 | The correct and automated packaging of dependency licenses is an ongoing discussion. Please feel free to add your thoughs to `this <https://github.com/conda-forge/conda-forge.github.io/issues/1052>`__ discussion.
|
763 | 758 |
|
| 759 | +Extra |
| 760 | +----- |
| 761 | + |
| 762 | +.. _recipe_maintainer: |
| 763 | + |
| 764 | +Recipe Maintainer |
| 765 | +.................. |
| 766 | + |
| 767 | +A maintainer is an individual who is responsible for maintaining and updating one or more feedstock repositories and packages as well as their future versions. They have push access to the feedstock repositories of only the packages they maintain and can merge pull requests into it. |
| 768 | + |
| 769 | +Contributing a recipe for package makes you the ``maintainer`` of that package automatically. |
| 770 | +See `Maintainers Role <https://conda-forge.org/docs/maintainer/adding_pkgs.html#maintainer-role>`__ and `Maintaining Packages <https://conda-forge.org/docs/maintainer/updating_pkgs.html#maintaining-packages>`__ to learn more about what are the things that maintainers do. |
| 771 | +If you wish to be a maintainer of a certain package, you should contact current maintainers and open an issue in that package's feedstock with the following command: |
| 772 | + |
| 773 | +``@conda-forge-admin, please add user @username`` |
| 774 | + |
| 775 | +where username is the GitHub username of the new maintainer to be added. Please refer to `Becoming a maintainer <https://conda-forge.org/docs/orga/guidelines.html#becoming-a-maintainer>`__ and `Updating the maintainer <https://conda-forge.org/docs/maintainer/updating_pkgs.html#updating-the-maintainer-list>`__ for detailed instructions. |
| 776 | + |
| 777 | +.. _feedstock_name: |
| 778 | + |
| 779 | +Feedstock name |
| 780 | +.............. |
| 781 | + |
| 782 | +If you want the name of the feedstock to be different from the package name in the staged-recipes, you can use the ``feedstock-name`` directive in the recipe of that package, like this: |
| 783 | + |
| 784 | +.. code-block:: yaml |
| 785 | +
|
| 786 | + extra: |
| 787 | + feedstock-name: <name> |
| 788 | +
|
| 789 | +Here, ``<name>`` is the name you would want for the feedstock. |
| 790 | + |
764 | 791 | Miscellaneous
|
765 | 792 | =============
|
766 | 793 |
|
|
0 commit comments