Update doc comments and doc initialization

Author: MaggieKimani1

README.md

@@ -84,7 +84,7 @@ var httpClient = new HttpClient
 var stream = await httpClient.GetStreamAsync("master/examples/v3.0/petstore.yaml");
 
 // Read V3 as YAML
-var openApiDocument = new OpenApiStreamReader().Read(stream, out var diagnostic);
+var openApiDocument = OpenApiDocument.LoadAsync(stream).OpenApiDocument;
 
 // Write V2 as JSON
 var outputString = openApiDocument.Serialize(OpenApiSpecVersion.OpenApi2_0, OpenApiFormat.Json);

src/Microsoft.OpenApi/Reader/OpenApiReaderSettings.cs

@@ -5,7 +5,6 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Text.Json.Nodes;
-using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.MicrosoftExtensions;
 using Microsoft.OpenApi.Validations;
@@ -77,7 +76,7 @@ public class OpenApiReaderSettings
 
         /// <summary>
         /// Whether to leave the <see cref="Stream"/> object open after reading
-        /// from an OpenApiStreamReader object.
+        /// from a StreamReader object.
         /// </summary>
         public bool LeaveStreamOpen { get; set; }
 

test/Microsoft.OpenApi.Readers.Tests/OpenApiReaderTests/OpenApiStreamReaderTests.cs

@@ -11,11 +11,11 @@
 
 namespace Microsoft.OpenApi.Readers.Tests.OpenApiReaderTests
 {
-    public class OpenApiStreamReaderTests
+    public class OpenApiDocumentLoadTests
     {
         private const string SampleFolderPath = "V3Tests/Samples/OpenApiDocument/";
 
-        public OpenApiStreamReaderTests()
+        public OpenApiDocumentLoadTests()
         {
             OpenApiReaderRegistry.RegisterReader("yaml", new OpenApiYamlReader());
         }