containers · Luap99 · Aug 26, 2025 · Aug 26, 2025
diff --git a/common/CODE-OF-CONDUCT.md → CODE-OF-CONDUCT.md b/common/CODE-OF-CONDUCT.md → CODE-OF-CONDUCT.md
diff --git a/common/CONTRIBUTING.md → CONTRIBUTING.md b/common/CONTRIBUTING.md → CONTRIBUTING.md
diff --git a/common/CONTRIBUTING_GO.md → CONTRIBUTING_GO.md b/common/CONTRIBUTING_GO.md → CONTRIBUTING_GO.md
diff --git a/common/CONTRIBUTING_RUST.md → CONTRIBUTING_RUST.md b/common/CONTRIBUTING_RUST.md → CONTRIBUTING_RUST.md
diff --git a/README.md b/README.md
@@ -0,0 +1,38 @@
+# container/container-libs
+
+This repository is a **monorepo** combining several core Go libraries and utilities from the [containers](https://github.com/containers) project.  
+
+It brings together:  
+
+- **[`common`](./common/)** → Shared Go code and configuration used across multiple containers projects.  
+- **[`storage`](./storage/)** → A Go library for managing container images, layers, and containers.  
+- **[`image`](./image/)** → A Go library for interacting with container images and registries.  
+
+These components are used by major container tools such as [Podman](https://github.com/containers/podman), [Buildah](https://github.com/containers/buildah), [CRI-O](https://github.com/cri-o/cri-o), and [Skopeo](https://github.com/containers/skopeo).
+
+
+---
+
+## Building
+
+Each subproject has its own README.md file with more instructions.
+
+## Contributing
+
+We welcome contributions!
+
+See the **[`CONTRIBUTING.md`](CONTRIBUTING.md)**, **[`CONTRIBUTING_GO.md`](CONTRIBUTING_GO.md)** and **[`CONTRIBUTING_RUST.md`](CONTRIBUTING_RUST.md)** files.
+
+## Code of Conduct
+
+See the **[`CODE-OF-CONDUCT.md`](CODE-OF-CONDUCT.md)** file.
+
+## Security and Disclosure Information Policy
+
+See the **[`SECURITY.md`](SECURITY.md)** file.
+
+
+## License
+
+- Apache License 2.0
+- SPDX-License-Identifier: Apache-2.0
diff --git a/common/SECURITY.md → SECURITY.md b/common/SECURITY.md → SECURITY.md
diff --git a/common/.github/CONTRIBUTING.md b/common/.github/CONTRIBUTING.md
diff --git a/common/.github/ISSUE_TEMPLATE.md b/common/.github/ISSUE_TEMPLATE.md
diff --git a/common/.github/PULL_REQUEST_TEMPLATE.md b/common/.github/PULL_REQUEST_TEMPLATE.md
diff --git a/common/.github/renovate.json5 b/common/.github/renovate.json5
diff --git a/common/.github/workflows/validate.yml b/common/.github/workflows/validate.yml
diff --git a/common/README.md b/common/README.md
@@ -41,7 +41,7 @@ syscalls available to containers.
 - [`pkg/sysinfo`](pkg/sysctl): `linux`, `solaris`, `windows`, `cgo`
 - [`pkg/cgroupv2`](pkg/cgroupv2): `linux`
 
-## [Contributing](CONTRIBUTING.md)
+## [Contributing](../CONTRIBUTING.md)
 
 When developing this library, please use `make` (or `make … BUILDTAGS=…`) to
 take advantage of the tests and validation.

diff --git a/image/.github/renovate.json5 b/image/.github/renovate.json5
diff --git a/image/.github/workflows/check_cirrus_cron.yml b/image/.github/workflows/check_cirrus_cron.yml
diff --git a/image/.github/workflows/codespell.yml b/image/.github/workflows/codespell.yml
diff --git a/image/CODE-OF-CONDUCT.md b/image/CODE-OF-CONDUCT.md
diff --git a/image/CONTRIBUTING.md b/image/CONTRIBUTING.md
diff --git a/image/README.md b/image/README.md
@@ -63,7 +63,7 @@ the primary downside is that creating new signatures with the Golang-only implem
 - `containers_image_sequoia`: Use Sequoia-PGP for signature verification instead of the default cgo/gpgme-based or the Golang-only OpenPGP implementations, and enable the `signature/simplesequoia` subpackage. This requires a support shared library installed on the system. Install https://github.com/ueno/podman-sequoia , and potentially update build configuration to point at it (compare `SEQUOIA_SONAME_DIR` in `Makefile`).
 - `containers_image_storage_stub`: Don’t import the `containers-storage:` transport in `github.com/containers/image/transports/alltransports`, to decrease the amount of required dependencies.  Use a stub which reports that the transport is not supported instead.
 
-## [Contributing](CONTRIBUTING.md)
+## [Contributing](../CONTRIBUTING.md)
 
 Information about contributing to this project.
 

diff --git a/image/SECURITY.md b/image/SECURITY.md
diff --git a/storage/.github/renovate.json5 b/storage/.github/renovate.json5
diff --git a/storage/CODE-OF-CONDUCT.md b/storage/CODE-OF-CONDUCT.md