Proposal: Artifacts TOC

[SteveLasker]

Artifacts Table of Contents

The following is the working plan for the Artifacts TOC.

Individual Content PRs

As each section will have various forms of feedback, I'll be breaking up the latest content into separate PRs.

This working TOC gives a bigger picture perspective of what's currently known. ("We don't know what we don't know") - so, help us know what you'd like to see.

Stable Links

As others provide links to content, moving content between different files and headings makes it more difficult to maintain those links. Getting the TOC (files and headings fixed) will minimize churn to consumers.

If you have other content you'd like to see added, please comment here so we can structure the files and headings appropriately.

Comments including:

• Needed Content (sections & scenarios)
• File Naming
• Heading Names, Within the Files

Working TOC

• Readme.md

  • What makes an artifact PR Overview content-prior to operator and author content #5
  • Artifacts as well known types PR Overview content-prior to operator and author content #5
  • Implementations- that support OCI Distribution PR Adds Implementers of OCI Artifacts #4
  • Definitions & Terms PR Collection of definitions and terms #3

• For Distribution Operators - Supporting Artifacts (supporting-artifacts.md)

  • Supporting Artifacts in a Registry
  • Well Known Types (consuming the list of published artifact types)
  • Displaying the Type, with Icons and Human Strings
  • Validating Artifacts
  • Importing Supported Artifacts to a Registry
  • Discovering Supported Artifacts (per registry, per repo)

• For Artifact Authors - Authoring and Publishing New Artifacts (registry-operators.md) - PR Artifact authors how to #6

  • Authoring new artifacts
  • Defining mediaTypes
    • unknown reserved
    • oci-image for docker/containerd
  • Annotations and config
  • Optional - Config Schema
  • Publishing new artifacts

• Supported Registries (implementations.md)

[mikebrow]

table of content thoughts need to move to the image spec..

[mikebrow]

closing for now due to pending archive action.. pls reopen if archive is not completed and/or if you believe this close to be in error