Skip to content

Summary section for archiving policy #28922

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 20, 2025
+21 −0
Merged

Summary section for archiving policy #28922

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
288ad5c
Summary section for archiving policy
stedolan Nov 18, 2025
a9286a1
clarify x-maintenance-intent semantics in summary
stedolan Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions governance/policies/archiving.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,26 @@
# opam Repository Archiving Policy

## Summary

To remain in the primary opam repository, a package version must:

- Have available sources
- Be installable (but not necessarily pass tests)
- on at least one supported platform
- with at least one recent compiler (currently, meaning 4.08+)
- Be maintained, according to the metadata of the latest version:
- `x-maintenance-intent: ["(latest)"]` means that only the latest version is maintained
- No `x-maintenance-intent` field means (for now) that all versions are maintained
- Other values are possible (see below for a full list)

Package versions which don't meet these criteria and are not dependencies of
anything meeting these criteria will be periodically archived, removing them
from the primary opam repo.

The full policy, including the precise criteria, the archiving process, and how
package versions may be marked maintained, is detailed below.


## Terminology

- The primary opam repository, (referred to here as the "primary repo") is located at [ocaml/opam-repository](https://github.com/ocaml/opam-repository). The primary repo is curated to ensure that compatible packages are co-installable on as many supported platforms as possible, and it is the default package repository.
Expand Down