Merge pull request #18571 from dvdksn/hub-registry

registry: clarify hub<>registry

content/registry.md

@@ -1,7 +1,7 @@
 ---
 title: Registry
-description: Registry documentation has moved
-keywords: registry, distribution
+description: The Docker Hub registry implementation 
+keywords: registry, distribution, docker hub, spec, schema, api, manifest, auth
 aliases:
   - /registry/compatibility/
   - /registry/deploying/
@@ -41,29 +41,46 @@ aliases:
 Registry, the open source implementation for storing and distributing container
 images and other content, has been donated to the CNCF. Registry now goes under
 the name of Distribution, and the documentation has moved to
-[distribution.github.io/distribution][docs].
+[distribution/distribution].
 
-For reference documentation on the API protocol that Distribution implements,
-see [Registry HTTP API][api].
+The Docker Hub registry implementation is based on Distribution. Docker Hub
+implements version 1.0.1 OCI distribution [specification]. For reference
+documentation on the API protocol that Docker Hub implements, refer to the OCI
+distribution specification.
 
-For documentation related to authentication, see:
+## Supported media types
+
+Docker Hub supports the following image manifest formats for pulling images:
+
+- [OCI image manifest]
+- [Docker image manifest version 2, schema 2]
+- Docker image manifest version 2, schema 1
+- Docker image manifest version 1
+
+You can push images with the following formats:
+
+- [OCI image manifest]
+- [Docker image manifest version 2, schema 2]
+
+Docker Hub also supports OCI artifacts. See [OCI artifacts].
+
+## Authentication
+
+For documentation related to authentication to the Docker Hub registry, see:
 
 - [Token authentication specification][token]
 - [OAuth 2.0 token authentication][oauth2]
 - [JWT authentication][jwt]
 - [Token scope and access][scope]
 
-For information about image manifests, see:
-
-- [Image Manifest Version 2, Schema 2][schema2]
-- [Image Manifest Version 2, Schema 1][schema1] (deprecated)
+<!-- links -->
 
-[spec]: https://github.com/opencontainers/distribution-spec
-[docs]: https://distribution.github.io/distribution/
-[api]: https://distribution.github.io/distribution/spec/api/
+[distribution/distribution]: https://distribution.github.io/distribution/
+[specification]: https://github.com/opencontainers/distribution-spec/blob/v1.0.1/spec.md
+[OCI image manifest]: https://github.com/opencontainers/image-spec/blob/main/manifest.md
+[Docker image manifest version 2, schema 2]: https://distribution.github.io/distribution/spec/manifest-v2-2/
+[OCI artifacts]: /docker-hub/oci-artifacts/
 [oauth2]: https://distribution.github.io/distribution/spec/auth/oauth/
 [jwt]: https://distribution.github.io/distribution/spec/auth/jwt/
 [token]: https://distribution.github.io/distribution/spec/auth/token/
 [scope]: https://distribution.github.io/distribution/spec/auth/scope/
-[schema2]: https://distribution.github.io/distribution/spec/manifest-v2-2/
-[schema1]: https://distribution.github.io/distribution/spec/deprecated-schema-v1/

data/toc.yaml

@@ -1989,6 +1989,8 @@ Manuals:
     title: Vulnerability scanning
   - path: /docker-hub/image-management/
     title: Advanced Image Management
+  - path: /registry/
+    title: Registry
   - path: /docker-hub/oci-artifacts/
     title: OCI artifacts
   - path: /docker-hub/release-notes/