Add comments.

Author: faddiv

src/FluentAssertions.AspNetCore.Mvc/ActionResultAssertions.cs

@@ -86,11 +86,24 @@ public EmptyResult BeEmptyResult(string reason, params object[] reasonArgs)
             return Subject as EmptyResult;
         }
 
+        /// <summary>
+        /// Asserts that the subject is an <see cref="JsonResult"/>.
+        /// </summary>
         public JsonResultAssertions BeJsonResult()
         {
             return BeJsonResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is an <see cref="JsonResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public JsonResultAssertions BeJsonResult(string reason, params object[] reasonArgs)
         {
             Execute.Assertion

src/FluentAssertions.AspNetCore.Mvc/JsonResultAssertions.cs

@@ -2,13 +2,22 @@
 using FluentAssertions.Primitives;
 using Microsoft.AspNetCore.Mvc;
 using System;
+using System.Diagnostics;
 
 namespace FluentAssertions.AspNetCore.Mvc
 {
+    /// <summary>
+    ///     Contains a number of methods to assert that a <see cref="JsonResult" /> is in the expected state.
+    /// </summary>
+    [DebuggerNonUserCode]
     public class JsonResultAssertions : ObjectAssertions
     {
         #region Public Constructors
 
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="T:JsonResultAssertions" /> class.
+        /// </summary>
+        /// <param name="subject">The object to test assertion on</param>
         public JsonResultAssertions(JsonResult subject) : base(subject)
         {
 
@@ -18,6 +27,11 @@ public JsonResultAssertions(JsonResult subject) : base(subject)
 
         #region Public Properties
 
+        /// <summary>
+        ///     The value on the JsonResult
+        /// </summary>
+        public object Value => JsonResultSubject.Value;
+
         #endregion
 
         #region Private Properties
@@ -28,6 +42,18 @@ public JsonResultAssertions(JsonResult subject) : base(subject)
 
         #region Public Methods
 
+        /// <summary>
+        ///     Asserts that the value is the expected value using Equals.
+        /// </summary>
+        /// <param name="expectedValue">The expected value.</param>
+        /// <param name="reason">
+        ///     A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion
+        ///     is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        ///     Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
+        /// <returns></returns>
         public JsonResultAssertions WithValue(object expectedValue, string reason = "",
             params object[] reasonArgs)
         {