chore: enhance documentation and structure of UDP packet classes (#12)

Author: volodymyr-fed

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayIsNotPartial_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithField_GeneratesArrayCode#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithField_GeneratesArrayCode#MyCode.InlineArray.Generated.verified.cs

@@ -10,7 +10,7 @@
 namespace MyCode;
 
 /// <summary>
-/// Represents an inline array InlineArray with 42 elements of type <see cref="global::MyCode.Element"/>.
+/// Represents an inline array <see cref="InlineArray"/> with 42 elements.
 /// Provides basic equality comparison and hashing. Access elements using the indexer (e.g., myArray[0]).
 /// </summary>
 [InlineArray(42)]
@@ -23,28 +23,28 @@ partial struct InlineArray
 	public int Length => 42;
 
 	/// <summary>
-	/// Returns a <see cref="Span{T}"/> that represents the elements of this inline array.
+	/// Returns a <see cref="Span{global::MyCode.Element}"/> that represents the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// A <see cref="Span{T}"/> of length <c>42</c> that provides mutable access to the elements of the inline array.
+	/// A <see cref="Span{global::MyCode.Element}"/> of length <c>42</c> that provides mutable access to the elements of the inline array.
 	/// </returns>
 	public Span<global::MyCode.Element> AsSpan()
 		=> MemoryMarshal.CreateSpan(ref Unsafe.As<InlineArray, global::MyCode.Element>(ref this), 42);
 
 	/// <summary>
-	/// Returns a <see cref="ReadOnlySpan{T}"/> that represents the elements of this inline array.
+	/// Returns a <see cref="ReadOnlySpan{global::MyCode.Element}"/> that represents the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// A <see cref="ReadOnlySpan{T}"/> of length <c>42</c> that provides read-only access to the elements of the inline array.
+	/// A <see cref="ReadOnlySpan{global::MyCode.Element}"/> of length <c>42</c> that provides read-only access to the elements of the inline array.
 	/// </returns>
 	public ReadOnlySpan<global::MyCode.Element> AsReadOnlySpan()
 		=> MemoryMarshal.CreateReadOnlySpan(ref Unsafe.As<InlineArray, global::MyCode.Element>(ref this), 42);
 
 	/// <summary>
-	/// Returns an <see cref="IEnumerable{T}"/> that enumerates the elements of this inline array.
+	/// Returns an <see cref="IEnumerable{global::MyCode.Element}"/> that enumerates the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// An <see cref="IEnumerable{T}"/> that iterates over the elements of the inline array in order.
+	/// An <see cref="IEnumerable{global::MyCode.Element}"/> that iterates over the elements of the inline array in order.
 	/// </returns>
 	public IEnumerable<global::MyCode.Element> AsEnumerable()
 	{
@@ -107,7 +107,7 @@ public static InlineArray Create(ReadOnlySpan<global::MyCode.Element> source)
 		=> !(left == right);
 
 	/// <summary>
-	/// Implicitly converts an array of <see cref="global::MyCode.Element"/> to a <see cref="InlineArray"/>.
+	/// Implicitly converts an array to a <see cref="InlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source array; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">
@@ -120,7 +120,7 @@ public static implicit operator InlineArray(global::MyCode.Element[] source)
 		=> source is null ? new() : Create(source);
 
 	/// <summary>
-	/// Implicitly converts a <see cref="ReadOnlySpan{T}"/> of <see cref="global::MyCode.Element"/> to a <see cref="InlineArray"/>.
+	/// Implicitly converts a <see cref="ReadOnlySpan{global::MyCode.Element}"/> to a <see cref="InlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source span; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">
@@ -133,7 +133,7 @@ public static implicit operator InlineArray(ReadOnlySpan<global::MyCode.Element>
 		=> Create(source);
 
 	/// <summary>
-	/// Implicitly converts a <see cref="Span{T}"/> of <see cref="global::MyCode.Element"/> to a <see cref="InlineArray"/>.
+	/// Implicitly converts a <see cref="Span{global::MyCode.Element}"/> to a <see cref="InlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source span; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithNegativeLength_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithTwoAttributes_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithTwoInstanceFields_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithTypeInAttributeAndField_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithTypeInAttribute_GeneratesArrayCode#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithTypeInAttribute_GeneratesArrayCode#MyCode.ByteInlineArray.Generated.verified.cs

@@ -10,7 +10,7 @@
 namespace MyCode;
 
 /// <summary>
-/// Represents an inline array ByteInlineArray with 42 elements of type <see cref="byte"/>.
+/// Represents an inline array <see cref="ByteInlineArray"/> with 42 elements.
 /// Provides basic equality comparison and hashing. Access elements using the indexer (e.g., myArray[0]).
 /// </summary>
 [InlineArray(42)]
@@ -25,28 +25,28 @@ partial record struct ByteInlineArray
 	public int Length => 42;
 
 	/// <summary>
-	/// Returns a <see cref="Span{T}"/> that represents the elements of this inline array.
+	/// Returns a <see cref="Span{byte}"/> that represents the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// A <see cref="Span{T}"/> of length <c>42</c> that provides mutable access to the elements of the inline array.
+	/// A <see cref="Span{byte}"/> of length <c>42</c> that provides mutable access to the elements of the inline array.
 	/// </returns>
 	public Span<byte> AsSpan()
 		=> MemoryMarshal.CreateSpan(ref Unsafe.As<ByteInlineArray, byte>(ref this), 42);
 
 	/// <summary>
-	/// Returns a <see cref="ReadOnlySpan{T}"/> that represents the elements of this inline array.
+	/// Returns a <see cref="ReadOnlySpan{byte}"/> that represents the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// A <see cref="ReadOnlySpan{T}"/> of length <c>42</c> that provides read-only access to the elements of the inline array.
+	/// A <see cref="ReadOnlySpan{byte}"/> of length <c>42</c> that provides read-only access to the elements of the inline array.
 	/// </returns>
 	public ReadOnlySpan<byte> AsReadOnlySpan()
 		=> MemoryMarshal.CreateReadOnlySpan(ref Unsafe.As<ByteInlineArray, byte>(ref this), 42);
 
 	/// <summary>
-	/// Returns an <see cref="IEnumerable{T}"/> that enumerates the elements of this inline array.
+	/// Returns an <see cref="IEnumerable{byte}"/> that enumerates the elements of this inline array.
 	/// </summary>
 	/// <returns>
-	/// An <see cref="IEnumerable{T}"/> that iterates over the elements of the inline array in order.
+	/// An <see cref="IEnumerable{byte}"/> that iterates over the elements of the inline array in order.
 	/// </returns>
 	public IEnumerable<byte> AsEnumerable()
 	{
@@ -109,7 +109,7 @@ public static ByteInlineArray Create(ReadOnlySpan<byte> source)
 		=> !(left == right);
 
 	/// <summary>
-	/// Implicitly converts an array of <see cref="byte"/> to a <see cref="ByteInlineArray"/>.
+	/// Implicitly converts an array to a <see cref="ByteInlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source array; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">
@@ -122,7 +122,7 @@ public static implicit operator ByteInlineArray(byte[] source)
 		=> source is null ? new() : Create(source);
 
 	/// <summary>
-	/// Implicitly converts a <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> to a <see cref="ByteInlineArray"/>.
+	/// Implicitly converts a <see cref="ReadOnlySpan{byte}"/> to a <see cref="ByteInlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source span; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">
@@ -135,7 +135,7 @@ public static implicit operator ByteInlineArray(ReadOnlySpan<byte> source)
 		=> Create(source);
 
 	/// <summary>
-	/// Implicitly converts a <see cref="Span{T}"/> of <see cref="byte"/> to a <see cref="ByteInlineArray"/>.
+	/// Implicitly converts a <see cref="Span{byte}"/> to a <see cref="ByteInlineArray"/>.
 	/// Copies up to <c>42</c> elements from the source span; extra elements are ignored, and missing elements are default-initialized.
 	/// </summary>
 	/// <param name="source">

F1Game.UDP.SourceGenerator.Tests/snapshots/AutoInlineArrayGeneratorTests.ArrayWithZeroLength_AddsDiagnostic#F1Game.UDP.SourceGenerator.AutoInlineArrayAttribute.Generated.verified.cs

@@ -32,6 +32,7 @@ internal sealed class AutoInlineArrayAttribute : Attribute
 {
 	/// <summary>Initializes a new instance of the <see cref="AutoInlineArrayAttribute"/> class.</summary>
 	/// <param name="length">The number of elements in the inline array. Must be greater than 0.</param>
+	/// <param name="elementType">The type of the element in the inline array. Optional if it can be inferred.</param>
 	public AutoInlineArrayAttribute(int length, Type? elementType = null)
 	{
 		if (length <= 0)