[ACR] Update client documentation and a few other changes (Azure#35224)

* Update doc comments on ContainerRegistryContentClient

* Update custom manifest samples and CHANGELOG.

* Reduce size of large blob for upload/download test to stay under the time limit.

* Export API

Author: annelo-msft

sdk/containerregistry/Azure.Containers.ContainerRegistry/CHANGELOG.md

@@ -4,12 +4,28 @@
 
 ### Features Added
 
+- Added a `DownloadStreaming()` method to `ContainerRegistryContentClient`.  This method returns a network stream in the returned result that the caller must dispose after use.
+- Added overloads to the `DownloadBlobTo()` method that take a file path instead of a Stream.
+
 ### Breaking Changes
 
-### Bugs Fixed
+- Renamed `ContainerRegistryBlobClient` to `ContainerRegistryContentClient`.
+- Moved `ContainerRegistryContentClient` and related types into main namespace.
+- Removed `MaxChunkSize` property from `ContainerRegistryClientOptions`.
+- Renamed `ContainerRegistryContentClient.DownloadBlob()` method to `DownloadBlobContent()`.
+- Renamed `DownloadBlobResult` to `DownloadRegistryBlobResult`.
+- Renamed `UploadBlobResult` to `UploadRegistryBlobResult`.
+- Renamed `ContainerRegistryContentClient.DownloadManifest()` to `GetManifest()` and `DownloadManifestResult` to `GetManifestResult`.
+- Renamed `ContainerRegistryContentClient.UploadManifest ()` to `SetManifest()` and `UploadManifestResult` to `SetManifestResult`.
+- Renamed `GetManifestResult.Content` name to `GetManifestResult.Manifest`.
+- Removed `GetManifestResult.AsOciManifest()` method in favor of `BinaryData.ToObjectFromJson<OciImageManifest>()`.
+- Changed `Url`, `Source` and `Documentation` properties on `OciAnnotations` type to `Uri` type.
+- Renamed `OciAnnotations.Config` to `OciAnnotations.Configuration`.
 
 ### Other Changes
 
+- Removed requirement to pass `Audience` property on `ContainerRegistryClientOptions` in order to create any client instance.
+
 ## 1.1.0-beta.8 (2023-03-13)
 
 ### Features Added

sdk/containerregistry/Azure.Containers.ContainerRegistry/api/Azure.Containers.ContainerRegistry.netstandard2.0.cs

@@ -197,7 +197,7 @@ public static partial class ContainerRegistryModelFactory
         public static Azure.Containers.ContainerRegistry.ContainerRepositoryProperties ContainerRepositoryProperties(string registryLoginServer = null, string name = null, System.DateTimeOffset createdOn = default(System.DateTimeOffset), System.DateTimeOffset lastUpdatedOn = default(System.DateTimeOffset), int manifestCount = 0, int tagCount = 0, bool? canDelete = default(bool?), bool? canWrite = default(bool?), bool? canList = default(bool?), bool? canRead = default(bool?)) { throw null; }
         public static Azure.Containers.ContainerRegistry.DownloadRegistryBlobResult DownloadRegistryBlobResult(string digest = null, System.BinaryData content = null) { throw null; }
         public static Azure.Containers.ContainerRegistry.GetManifestResult GetManifestResult(string digest = null, string mediaType = null, System.BinaryData manifest = null) { throw null; }
-        public static Azure.Containers.ContainerRegistry.SetManifestResult UploadManifestResult(string digest = null) { throw null; }
+        public static Azure.Containers.ContainerRegistry.SetManifestResult SetManifestResult(string digest = null) { throw null; }
         public static Azure.Containers.ContainerRegistry.UploadRegistryBlobResult UploadRegistryBlobResult(string digest, long sizeInBytes) { throw null; }
     }
     public partial class ContainerRepository

sdk/containerregistry/Azure.Containers.ContainerRegistry/samples/Sample05_UploadDownloadImage.md

@@ -8,9 +8,9 @@ An image consists of a manifest file, config file, and one or more layer files.
 
 ## Create Client
 
-Create a `ContainerRegistryBlobClient` for the registry, passing the repository, credentials, and client options.
+Create a `ContainerRegistryContentClient` for the registry, passing the repository, credentials, and client options.
 
-```C# Snippet:ContainerRegistry_Samples_CreateBlobClient
+```C# Snippet:ContainerRegistry_Samples_CreateContentClient
 // Get the service endpoint from the environment
 Uri endpoint = new(Environment.GetEnvironmentVariable("REGISTRY_ENDPOINT"));
 
@@ -105,7 +105,7 @@ static string TrimSha(string digest)
 }
 ```
 
-## Upload a custom manifest
+## Upload a Docker manifest
 
 To upload an image with a custom manifest type, pass the `ManifestMediaType` to the `UploadManifest` method.
 
@@ -114,7 +114,7 @@ To upload an image with a custom manifest type, pass the `ManifestMediaType` to
 var manifestList = new
 {
     schemaVersion = 2,
-    mediaType = ManifestMediaType.DockerManifestList.ToString(),
+    mediaType = "application/vnd.docker.distribution.manifest.list.v2+json",
     manifests = new[]
     {
         new
@@ -134,9 +134,9 @@ BinaryData content = BinaryData.FromObjectAsJson(manifestList);
 await client.SetManifestAsync(content, tag: "sample", ManifestMediaType.DockerManifestList);
 ```
 
-## Download a custom manifest
+## Download a manifest of an unknown type
 
-To download a manifest of an unknown type, pass possible values to the list of acceptable media types.  The media type of the manifest is returned on the `DownloadManifestResult`.
+If you are downloading a manifest where the media type isn't known ahead of time, check the `MediaType` property returned on the `DownloadManifestResult` to determine the type.
 
 ```C# Snippet:ContainerRegistry_Samples_DownloadCustomManifestAsync
 GetManifestResult result = await client.GetManifestAsync("sample");