Add missing code documentation

Author: Arlodotexe

src/Downloader/KuboDistributionArchitecture.cs

@@ -1,8 +1,22 @@
 namespace OwlCore.Kubo;
 
+/// <summary>
+/// Represents an architecture for a Kubo distribution.
+/// </summary>
 public class KuboDistributionArchitecture
 {
+    /// <summary>
+    /// A relative download link for this architecture binary.
+    /// </summary>
     public string? Link { get; set; }
+    
+    /// <summary>
+    /// The Cid for this architecture binary.
+    /// </summary>
     public string? Cid { get; set; }
+    
+    /// <summary>
+    /// A hash that can be used to verify the downloaded data.
+    /// </summary>
     public string? Sha512 { get; set; }
 }

src/Downloader/KuboDistributionData.cs

@@ -1,16 +1,47 @@
-using System;
-using System.Collections.Generic;
-
-namespace OwlCore.Kubo;
+namespace OwlCore.Kubo;
 
+/// <summary>
+/// Represents data about a Kubo distribution.
+/// </summary>
 public class KuboDistributionData
 {
+    /// <summary>
+    /// A unique identifier for this distribution.
+    /// </summary>
     public string? Id { get; set; }
+    
+    /// <summary>
+    /// The version for this distribution.
+    /// </summary>
     public string? Version { get; set; }
+    
+    /// <summary>
+    /// The release link for this distribution.
+    /// </summary>
     public string? ReleaseLink { get; set; }
+    
+    /// <summary>
+    /// The name of this distribution.
+    /// </summary>
     public string? Name { get; set; }
+    
+    /// <summary>
+    /// The owner of this distribution.
+    /// </summary>
     public string? Owner { get; set; }
+    
+    /// <summary>
+    /// A description of this distribution.
+    /// </summary>
     public string? Description { get; set; }
+    
+    /// <summary>
+    /// The published date.
+    /// </summary>
     public string? Date { get; set; }
+    
+    /// <summary>
+    /// The platforms for this distribution.
+    /// </summary>
     public Dictionary<string, KuboDistributionPlatform>? Platforms { get; set; }
 }

src/Downloader/KuboDistributionJsonContext.cs

@@ -2,6 +2,9 @@
 
 namespace OwlCore.Kubo;
 
+/// <summary>
+/// Json context for serializing and deserializing <see cref="KuboDistributionData"/>.
+/// </summary>
 [JsonSourceGenerationOptions(PropertyNamingPolicy = JsonKnownNamingPolicy.CamelCase)]
 [JsonSerializable(typeof(KuboDistributionData))]
 public partial class KuboDistributionJsonContext : JsonSerializerContext

src/Downloader/KuboDistributionPlatform.cs

@@ -1,9 +1,17 @@
-using System.Collections.Generic;
-
-namespace OwlCore.Kubo;
+namespace OwlCore.Kubo;
 
+/// <summary>
+/// Represents a distribution platform for Kubo.
+/// </summary>
 public class KuboDistributionPlatform
 {
+    /// <summary>
+    /// The name of the distribution platform.
+    /// </summary>
     public string? Name { get; set; }
+    
+    /// <summary>
+    /// The architectures available for this distribution.
+    /// </summary>
     public Dictionary<string, KuboDistributionArchitecture>? Archs { get; set; }
 }

src/Extensions/GenericKuboExtensions.cs

@@ -127,10 +127,10 @@ public static async Task<IKey> GetOrCreateKeyAsync(this IKeyApi keyApi, string k
     /// <param name="client">The client to use for communicating with the ipfs network.</param>
     /// <param name="keyName">The name of the key to get or create.</param>
     /// <param name="ipnsLifetime">The lifetime this ipns key should stay alive before needing to be rebroadcast by this node.</param>
+    /// <param name="nocache">Whether to use Kubo's cache when resolving ipns keys.</param>
     /// <param name="size">The size of the key to create.</param>
     /// <param name="cancellationToken">A token that can be used to cancel the ongoing task.</param>
     /// <param name="getDefaultValue">Given the created ipns key, provides the default value to be published to it.</param>
-    /// <returns></returns>
     public static async Task<(IKey Key, TResult Value)> GetOrCreateKeyAsync<TResult>(this ICoreApi client, string keyName, Func<IKey, TResult> getDefaultValue, TimeSpan ipnsLifetime, bool nocache, int size = 4096, CancellationToken cancellationToken = default)
     {
         // Get or create ipns key