summaryrefslogtreecommitdiffstats
path: root/pkg/registry/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'pkg/registry/README.md')
-rw-r--r--pkg/registry/README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/pkg/registry/README.md b/pkg/registry/README.md
new file mode 100644
index 0000000..5e58bbc
--- /dev/null
+++ b/pkg/registry/README.md
@@ -0,0 +1,14 @@
+# `pkg/registry`
+
+This package implements a Docker v2 registry and the OCI distribution specification.
+
+It is designed to be used anywhere a low dependency container registry is needed, with an initial focus on tests.
+
+Its goal is to be standards compliant and its strictness will increase over time.
+
+This is currently a low flightmiles system. It's likely quite safe to use in tests; If you're using it in production, please let us know how and send us PRs for integration tests.
+
+Before sending a PR, understand that the expectation of this package is that it remain free of extraneous dependencies.
+This means that we expect `pkg/registry` to only have dependencies on Go's standard library, and other packages in `go-containerregistry`.
+
+You may be asked to change your code to reduce dependencies, and your PR might be rejected if this is deemed impossible.