[RPW] Checking current situation with docs

https://jira.unity3d.com/browse/XPIPELINE-848

Author: kirill-titov-u

Packages/com.unity.render-pipelines.core/Editor/AdditionalPropertiesState.cs

@@ -22,7 +22,7 @@ void RepaintAll()
 
         /// <summary>Get or set the state given the mask.</summary>
         /// <param name="mask">The filtering mask</param>
-        /// <returns>True: All flagged area are expended</returns>
+        /// <value>True: All flagged area are expended</value>
         public bool this[TState mask]
         {
             get => GetAdditionalPropertiesState(mask);
@@ -67,6 +67,10 @@ internal AnimFloat GetAnimation(TState mask)
             return anim;
         }
 
+        /// <summary>
+        /// Resets the animation associated with the given mask to a default state with the animated value set to 1.0 and the target value set to 0.0.
+        /// </summary>
+        /// <param name="mask">The state mask used to retrieve the associated animation.</param>
         protected internal void ResetAnimation(TState mask)
         {
             AnimFloat anim = GetAnimation(mask);
@@ -100,6 +104,9 @@ public void UnregisterEditor(Editor editor)
     public class AdditionalPropertiesState<TState, TTarget> : AdditionalPropertiesStateBase<TState>
         where TState : struct, IConvertible
     {
+        /// <summary>
+        /// Stores the expanded or collapsed state of each section defined by <typeparamref name="TState"/>.
+        /// </summary>
         protected internal EditorPrefBoolFlags<TState> m_State;
 
 

Packages/com.unity.render-pipelines.core/Editor/Analytics/AnalyticsUtils.cs

@@ -231,6 +231,7 @@ static string[] ToStringArray(Dictionary<string, string> diff)
         /// <param name="current">The current object to obtain the fields and values.</param>
         /// <param name="compareAndSimplifyWithDefault">If a comparison against the default value must be done.</param>
         /// <returns>The nested columns in form of {key.nestedKey : value} </returns>
+        /// <exception cref="ArgumentNullException">Throws an exception if current parameter is null.</exception>
         public static string[] ToNestedColumn<T>([DisallowNull] this T current, bool compareAndSimplifyWithDefault = false)
             where T : new()
         {
@@ -269,6 +270,7 @@ public static string[] ToNestedColumn<T>([DisallowNull] this T current, bool com
         /// <param name="current">The current object to obtain the fields and values.</param>
         /// <param name="defaultInstance">The default instance to compare values</param>
         /// <returns>The nested columns in form of {key.nestedKey : value} </returns>
+        /// <exception cref="ArgumentNullException">Throws an exception if the current or defaultInstance parameters are null.</exception>
         public static string[] ToNestedColumn<T>([DisallowNull] this T current, T defaultInstance)
         {
             if (current == null)
@@ -293,7 +295,7 @@ public static string[] ToNestedColumn<T>([DisallowNull] this T current, T defaul
         /// <param name="defaultObject">The default object</param>
         /// <param name="compareAndSimplifyWithDefault">If a comparison against the default value must be done.</param>
         /// <returns>The nested columns in form of {key.nestedKey : value} </returns>
-        /// <exception cref="ArgumentNullException"></exception>
+        /// <exception cref="ArgumentNullException">Throws an exception if the current parameter is null.</exception>
         public static string[] ToNestedColumnWithDefault<T>([DisallowNull] this T current, [DisallowNull] T defaultObject, bool compareAndSimplifyWithDefault = false)
         {
             if (current == null)

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Environment.Drawers.cs

@@ -1,6 +1,5 @@
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
         /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Environment.Skin.cs

@@ -2,12 +2,8 @@
 
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
-        /// <summary>
-        /// Environment section
-        /// </summary>
         public static partial class Environment
         {
             /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Output.Drawers.cs

@@ -2,7 +2,6 @@
 
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
         /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Output.Skin.cs

@@ -2,12 +2,8 @@
 
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
-        /// <summary>
-        /// Output section
-        /// </summary>
         public static partial class Output
         {
             /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.PhysicalCamera.Drawers.cs

@@ -4,10 +4,6 @@
 
 namespace UnityEditor.Rendering
 {
-
-    using CED = CoreEditorDrawer<ISerializedCamera>;
-
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
         /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.PhysicalCamera.Skin.cs

@@ -3,12 +3,8 @@
 
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
-        /// <summary>
-        /// Physical camera content content
-        /// </summary>
         public static partial class PhysicalCamera
         {
             /// <summary>

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Rendering.Drawers.cs

@@ -1,6 +1,5 @@
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
         public static partial class Rendering

Packages/com.unity.render-pipelines.core/Editor/Camera/CameraUI.Rendering.Skin.cs

@@ -2,7 +2,6 @@
 
 namespace UnityEditor.Rendering
 {
-    /// <summary> Camera UI Shared Properties among SRP</summary>
     public static partial class CameraUI
     {
         /// <summary>