Remaining fixes

Author: michalChrobot

com.unity.netcode.gameobjects/Runtime/Messaging/GenerateSerializationForGenericParameterAttribute.cs

@@ -19,12 +19,12 @@ namespace Unity.Netcode
     /// <br/>
     /// The parameter is indicated by index (and is 0-indexed); for example:
     /// <br/>
-    /// <code>
+    /// <c>
     /// [SerializesGenericParameter(1)]
     /// public class MyClass&lt;TTypeOne, TTypeTwo&gt;
     /// {
     /// }
-    /// </code>
+    /// </c>
     /// <br/>
     /// This tells the code generation for <see cref="NetworkVariableSerialization{T}"/> to generate
     /// serialized code for <b>TTypeTwo</b> (generic parameter 1).
@@ -38,7 +38,7 @@ namespace Unity.Netcode
     /// <br/>
     /// This attribute is properly inherited by subclasses. For example:
     /// <br/>
-    /// <code>
+    /// <c>
     /// [SerializesGenericParameter(0)]
     /// public class MyClass&lt;T&gt;
     /// {
@@ -63,7 +63,7 @@ namespace Unity.Netcode
     ///     public MySubclass2&lt;Bar&gt; TheValue;
     ///     public MySubclass3&lt;Baz, Qux&gt; TheValue;
     /// }
-    /// </code>
+    /// </c>
     /// <br/>
     /// The above code will trigger generation of serialization code for <b>Foo</b> (passed directly to the
     /// base class), <b>Bar</b> (passed indirectly to the base class), <b>Baz</b> (passed indirectly to the base class),

com.unity.netcode.gameobjects/Runtime/Serialization/FastBufferWriter.cs

@@ -455,9 +455,9 @@ public void WriteNetworkSerializable<T>(T[] array, int count = -1, int offset =
         /// <summary>
         /// Write a NativeArray of INetworkSerializables
         /// </summary>
-        /// <param name="array">The value to write</param>
-        /// <param name="count"></param>
-        /// <param name="offset"></param>
+        /// <param name="array">The NativeArray containing the values to write</param>
+        /// <param name="count">The number of elements to write. If -1 (default), writes array.Length - offset elements</param>
+        /// <param name="offset">The starting position in the array. Defaults to 0</param>
         /// <typeparam name="T">The type of the value</typeparam>
         public void WriteNetworkSerializable<T>(NativeArray<T> array, int count = -1, int offset = 0) where T : unmanaged, INetworkSerializable
         {
@@ -473,10 +473,10 @@ public void WriteNetworkSerializable<T>(NativeArray<T> array, int count = -1, in
         /// <summary>
         /// Write a NativeList of INetworkSerializables
         /// </summary>
-        /// <param name="array">The value to write</param>
-        /// <param name="count"></param>
-        /// <param name="offset"></param>
-        /// <typeparam name="T"></typeparam>
+        /// <param name="array">The NativeArray containing the values to write</param>
+        /// <param name="count">The number of elements to write. If -1 (default), writes array.Length - offset elements</param>
+        /// <param name="offset">The starting position in the array. Defaults to 0/param>
+        /// <typeparam name="T">The type of the value</typeparam>
         public void WriteNetworkSerializable<T>(NativeList<T> array, int count = -1, int offset = 0) where T : unmanaged, INetworkSerializable
         {
             int sizeInTs = count != -1 ? count : array.Length - offset;

com.unity.netcode.gameobjects/Runtime/Serialization/NetworkObjectReference.cs

@@ -25,8 +25,8 @@ public ulong NetworkObjectId
         /// Creates a new instance of the <see cref="NetworkObjectReference"/> struct.
         /// </summary>
         /// <param name="networkObject">The <see cref="NetworkObject"/> to reference.</param>
-        /// <exception cref="ArgumentNullException"></exception>
-        /// <exception cref="ArgumentException"></exception>
+        /// <exception cref="ArgumentNullException">Thrown when networkObject is null (creates a null reference instead of throwing)</exception>
+        /// <exception cref="ArgumentException">Thrown when the NetworkObject is not spawned. NetworkObjectReference can only be created from spawned NetworkObjects</exception>
         public NetworkObjectReference(NetworkObject networkObject)
         {
             if (networkObject == null)
@@ -47,8 +47,8 @@ public NetworkObjectReference(NetworkObject networkObject)
         /// Creates a new instance of the <see cref="NetworkObjectReference"/> struct.
         /// </summary>
         /// <param name="gameObject">The GameObject from which the <see cref="NetworkObject"/> component will be referenced.</param>
-        /// <exception cref="ArgumentNullException"></exception>
-        /// <exception cref="ArgumentException"></exception>
+        /// <exception cref="ArgumentNullException">Thrown when networkObject is null (creates a null reference instead of throwing)</exception>
+        /// <exception cref="ArgumentException">Thrown when the NetworkObject is not spawned. NetworkObjectReference can only be created from spawned NetworkObjects</exception>
         public NetworkObjectReference(GameObject gameObject)
         {
             if (gameObject == null)

com.unity.netcode.gameobjects/Runtime/Spawning/NetworkPrefabHandler.cs

@@ -24,7 +24,7 @@ public interface INetworkPrefabInstanceHandler
         /// <param name="ownerClientId">the owner for the <see cref="NetworkObject"/> to be instantiated</param>
         /// <param name="position">the initial/default position for the <see cref="NetworkObject"/> to be instantiated</param>
         /// <param name="rotation">the initial/default rotation for the <see cref="NetworkObject"/> to be instantiated</param>
-        /// <returns></returns>
+        /// <returns>The instantiated NetworkObject instance. Returns null if instantiation fails.</returns>
         NetworkObject Instantiate(ulong ownerClientId, Vector3 position, Quaternion rotation);
 
         /// <summary>

com.unity.netcode.gameobjects/Runtime/Transports/NetworkTransport.cs

@@ -6,7 +6,7 @@ namespace Unity.Netcode
     /// <summary>
     /// The generic transport class all Netcode for GameObjects network transport implementations
     /// derive from.  Use this class to add a custom transport.
-    /// <see cref="Transports.UTP.UnityTransport"> for an example of how a transport is integrated</seealso>
+    /// <see cref="Transports.UTP.UnityTransport"/> for an example of how a transport is integrated
     /// </summary>
     public abstract class NetworkTransport : MonoBehaviour
     {