Updated comments for common types.

Author: KristofferStrube

src/KristofferStrube.Blazor.FileAPI/Blob.InProcess.cs

@@ -4,9 +4,7 @@
 
 namespace KristofferStrube.Blazor.FileAPI;
 
-/// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#blob-section">Blob browser specs</see>
-/// </summary>
+/// <inheritdoc/>
 [IJSWrapperConverter]
 public class BlobInProcess : Blob, IJSInProcessCreatable<BlobInProcess, Blob>
 {

src/KristofferStrube.Blazor.FileAPI/Blob.cs

@@ -5,8 +5,11 @@
 namespace KristofferStrube.Blazor.FileAPI;
 
 /// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#blob-section">Blob browser specs</see>
+/// A <see cref="Blob"/> object refers to a byte sequence,
+/// and has a <see cref="GetSizeAsync"/> attribute which is the total number of bytes in the byte sequence,
+/// and a <see cref="GetTypeAsync"/> attribute, which is an ASCII-encoded string in lower case representing the media type of the byte sequence.
 /// </summary>
+/// <remarks><see href="https://www.w3.org/TR/FileAPI/#blob-section">See the API definition here</see></remarks>
 [IJSWrapperConverter]
 public class Blob : BaseJSWrapper, IJSCreatable<Blob>
 {

src/KristofferStrube.Blazor.FileAPI/File.InProcess.cs

@@ -4,9 +4,7 @@
 
 namespace KristofferStrube.Blazor.FileAPI;
 
-/// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#file-section">File browser specs</see>
-/// </summary>
+/// <inheritdoc/>
 [IJSWrapperConverter]
 public class FileInProcess : File, IJSInProcessCreatable<FileInProcess, File>
 {

src/KristofferStrube.Blazor.FileAPI/File.cs

@@ -4,8 +4,11 @@
 namespace KristofferStrube.Blazor.FileAPI;
 
 /// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#file-section">File browser specs</see>
+/// A File object is a <see cref="Blob"/> object with a <see cref="GetNameAsync"/> attribute, which is a string;
+/// it can be created within the web application via a constructor,
+/// or is a reference to a byte sequence from a file from the underlying (OS) file system.
 /// </summary>
+/// <remarks><see href="https://www.w3.org/TR/FileAPI/#file-section">See the API definition here</see></remarks>
 [IJSWrapperConverter]
 public class File : Blob, IJSCreatable<File>
 {

src/KristofferStrube.Blazor.FileAPI/FileReader.InProcess.cs

@@ -6,9 +6,7 @@
 
 namespace KristofferStrube.Blazor.FileAPI;
 
-/// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#dfn-filereader">FileReader browser specs</see>
-/// </summary>
+/// <inheritdoc/>
 [IJSWrapperConverter]
 public class FileReaderInProcess : FileReader, IJSInProcessCreatable<FileReaderInProcess, FileReader>, IEventTargetInProcess
 {

src/KristofferStrube.Blazor.FileAPI/FileReader.cs

@@ -6,8 +6,9 @@
 namespace KristofferStrube.Blazor.FileAPI;
 
 /// <summary>
-/// <see href="https://www.w3.org/TR/FileAPI/#dfn-filereader">FileReader browser specs</see>
+/// A reader that can asynchronously start reads of <see cref="Blob"/>s or <see cref="File"/>s and listen for events for its progress until it finishes.
 /// </summary>
+/// <remarks><see href="https://www.w3.org/TR/FileAPI/#dfn-filereader">See the API definition here</see></remarks>
 [IJSWrapperConverter]
 public class FileReader : EventTarget, IJSCreatable<FileReader>
 {