You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/maintainer/updating_pkgs.rst
+13-6Lines changed: 13 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,14 @@ Maintaining packages
6
6
Important notes
7
7
===============
8
8
9
+
Packages on ``conda-forge`` are immutable
10
+
-----------------------------------------
11
+
12
+
As a matter of policy, we do not allow edits or the deletion of packages on ``conda-forge``. This
13
+
policy is very important as it increases the reliability and reproducibility of ``conda`` environments
14
+
made with the ``conda-forge`` channel. If you need to remove a package, please see the :ref:`section <maint_fix_broken_packages>`
15
+
on marking packages broken.
16
+
9
17
Forking and pull requests
10
18
-------------------------
11
19
@@ -159,10 +167,6 @@ We need to re-render when there are changes to the following parts of the feedst
159
167
- build issues that a feedstock configuration update will fix (follow us on `gitter <https://gitter.im/conda-forge/conda-forge.github.io>`_ to know about those);
160
168
161
169
162
-
163
-
164
-
165
-
166
170
Testing changes locally
167
171
=======================
168
172
@@ -203,7 +207,8 @@ Sometimes mistakes happen and a broken package ends up being uploaded to the con
203
207
204
208
If the only issue is in the package metadata, we can directly patch it using
205
209
the `repo data patches feedstock <https://github.com/conda-forge/conda-forge-repodata-patches-feedstock>`__.
206
-
To change the repo data for your package, make a PR on the feedstock.
210
+
Please make a PR there to add a patch. In order to ensure future versions have the required changes, you also
211
+
need to change recipe to reflect the metadata changes.
207
212
208
213
If instead the actual contents of the package are broken, the following steps will
209
214
remove broken packages from the ``main`` channel:
@@ -251,4 +256,6 @@ Once the PR is merged, our infrastructure will grant and revoke maintainer permi
251
256
Maintaining several versions
252
257
============================
253
258
254
-
TODO: LTS branch
259
+
If you'd like to maintain more than one version of your package, you can use branches on the feedstock. To do this, fork your feedstock and make
260
+
a meaningful branch name (e.g., `v1.X` or `v1.0`). Make the required changes to the recipe and rerender the feedstock. Then push this branch
261
+
from your fork to the upstream feedstock. Our CI services will automatically build any branches in addition to the default branch.
0 commit comments