Skip to content

Commit c19f24a

Browse files
authored
DOC more doc fixes
1 parent 52d725f commit c19f24a

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

src/maintainer/updating_pkgs.rst

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,14 @@ Maintaining packages
66
Important notes
77
===============
88

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+
917
Forking and pull requests
1018
-------------------------
1119

@@ -159,10 +167,6 @@ We need to re-render when there are changes to the following parts of the feedst
159167
- 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);
160168

161169

162-
163-
164-
165-
166170
Testing changes locally
167171
=======================
168172

@@ -203,7 +207,8 @@ Sometimes mistakes happen and a broken package ends up being uploaded to the con
203207

204208
If the only issue is in the package metadata, we can directly patch it using
205209
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.
207212

208213
If instead the actual contents of the package are broken, the following steps will
209214
remove broken packages from the ``main`` channel:
@@ -251,4 +256,6 @@ Once the PR is merged, our infrastructure will grant and revoke maintainer permi
251256
Maintaining several versions
252257
============================
253258

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

Comments
 (0)