Skip to content
This repository has been archived by the owner on May 15, 2024. It is now read-only.

Commit

Permalink
Update governance references
Browse files Browse the repository at this point in the history
Signed-off-by: Steve Lasker <[email protected]>
  • Loading branch information
SteveLasker committed Jul 22, 2021
1 parent f04bf0d commit d491403
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 7 deletions.
2 changes: 1 addition & 1 deletion GOVERNANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@

The aritfacts-spec follows the governance defined under [oras community governance][oras-org-governance].

[oras-org-governance]: https://github.com/oras-project/community/blob/66b6ba632f3fb722a0076c5f50c1692ac0b06571/governance/GOVERNANCE.md
[oras-org-governance]: https://github.com/oras-project/community/blob/main/governance/GOVERNANCE.md
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@

[OCI Artifacts][oci-artifacts] generalized the ability to persist artifacts within an [OCI Distribution conformant][oci-conformance] registry. The majority of cloud registries, products and projects support pushing and pulling OCI Artifacts to a registry enabling users to benefit from the performance, security, reliability capabilities. Thus avoiding the need to run, manage or care for **Y**et **A**nother **S**torage **S**ervice (YASS).

## How does ORAS Artifacts relate to OCI Artifacts?

OCI Artifacts defines how to implement stand-alone artifacts that can fit within the constraints of the image-spec. ORAS Artifacts uses the `manifest.config.mediaType` to identify the artifact is something other than a container image. While this validated the ability to generalize the **C**ontent **A**ddressable **S**torage (CAS) capabilities of [OCI Distribution][oci-distribution], a new set of artifacts require additional capabilities that aren't constrained to the image-spec. ORAS Artifacts provide a more generic means to store a wider range of artifact types, including references between artifacts.
For more info, see: [Discussion of a new manifest #41](https://github.com/opencontainers/artifacts/discussions/41)

## Table of Contents:

- [Overview](#overview)
Expand All @@ -11,6 +16,7 @@
- [ORAS Artifacts Referrers Spec][artifact-referrers-spec]
- [CNCF Distribution Support for ORAS Artifacts][cncf-distribution-reftypes]
- [ORAS experimental support for oras.artifact.manifest references][oras-artifacts] to `push`, `discover`, `pull` referenced artifact types.
- [Code of Conduct](#code-of-conduct)

## Overview

Expand All @@ -35,13 +41,9 @@ The artifact manifest approach to reference types is based on a new manifest, en

## Project status

The ORAS artifacts-spec is experimental with the goal of providing a working implementation of the [OCI reference types proposal][oci-reference-types-proposal]. The intent is that once sufficiently proven it will be presented to OCI TOB for recommendation to be part of the specifications under their governance. This decision was made with the OCI TOB during the [weekly discussion][oci-tob-weekly-discussion] on July 21, 2021 while they work on creating a process to incubate new work under the [OCI working group][oci-working-group-proposal].
The ORAS artifacts-spec is experimental with the goal of providing a working implementation of the [OCI reference types proposal][oci-reference-types-proposal]. The intent is that once sufficiently proven it will be presented to OCI TOB for recommendation to be part of the specifications under their governance.

## Q&A

- **Q**: How does OCI Artifacts relate to ORAS Artifacts?
- **A**: ORAS Artifacts defines how to implement stand-alone artifacts that can fit within the constraints of the image-spec. ORAS Artifacts uses the `manifest.config.mediaType` to identify the artifact is something other than a container image. While this validated the ability to generalize the **C**ontent **A**ddressable **S**torage (CAS) capabilities of [OCI Distribution][oci-distribution], a new set of artifacts require additional capabilities that aren't constrained to the image-spec. ORAS Artifacts provide a more generic means to store a wider range of artifact types, including references between artifacts.
For more info, see: [Discussion of a new manifest #41](https://github.com/opencontainers/artifacts/discussions/41)
This decision was made with the OCI TOB during the [weekly discussion][oci-tob-weekly-discussion] on July 21, 2021 while they work on creating a process to incubate new work under the [OCI working group][oci-working-group-proposal].

## Code of Conduct

Expand Down

0 comments on commit d491403

Please sign in to comment.