Add xml comments (#98)

Author: sungam3r

src/GraphQLParser/AST/GraphQLListType.cs

@@ -1,11 +1,12 @@
-namespace GraphQLParser.AST
+namespace GraphQLParser.AST
 {
     public class GraphQLListType : GraphQLType
     {
         public override ASTNodeKind Kind => ASTNodeKind.ListType;
 
         public GraphQLType? Type { get; set; }
 
+        /// <inheritdoc/>
         public override string ToString() => $"[{Type}]";
     }
-}
+}

src/GraphQLParser/AST/GraphQLListValue.cs

@@ -17,6 +17,7 @@ public GraphQLListValue(ASTNodeKind kind)
 
         public List<GraphQLValue>? Values { get; set; }
 
+        /// <inheritdoc/>
         public override string ToString() => AstValue!;
     }
 }

src/GraphQLParser/AST/GraphQLLocation.cs

@@ -3,9 +3,15 @@
 
 namespace GraphQLParser.AST
 {
+    /// <summary>
+    /// Provides information regarding the location of a node within a document's original query text.
+    /// </summary>
     [DebuggerDisplay("(Start={Start}, End={End})")]
     public readonly struct GraphQLLocation : IEquatable<GraphQLLocation>
     {
+        /// <summary>
+        /// Initializes a new instance with the specified parameters.
+        /// </summary>
         public GraphQLLocation(int start, int end)
         {
             Start = start;
@@ -14,28 +20,38 @@ public GraphQLLocation(int start, int end)
 
         /// <summary>
         /// The index for the start of the node in the source (i.e. it's inclusive).
-        ///
-        /// For example,
-        ///     { field { subfield } }
-        ///       ^ field.Location.Start = 2
+        /// <br/>
+        /// For example:
+        /// <code>
+        /// { field { subfield } }
+        /// <br/>
+        /// --^ field.Location.Start = 2
+        /// </code>
         /// </summary>
         public int Start { get; }
 
         /// <summary>
         /// The index for the character immediately after the node in the source (i.e. it's exclusive).
-        ///
-        /// For example,
-        ///     { field { subfield } }
-        ///                         ^ field.Location.End = 20
+        /// <br/>
+        /// For example:
+        /// <code>
+        /// { field { subfield } }
+        /// <br/>
+        /// --------------------^ field.Location.End = 20
+        /// </code>
         /// </summary>
         public int End { get; }
 
+        /// <inheritdoc/>
         public bool Equals(GraphQLLocation other) => Start == other.Start && End == other.End;
 
+        /// <inheritdoc/>
         public override bool Equals(object obj) => obj is GraphQLLocation l && Equals(l);
 
+        /// <inheritdoc/>
         public override int GetHashCode() => (Start, End).GetHashCode();
 
+        /// <inheritdoc/>
         public override string ToString() => $"({Start},{End})";
     }
 }

src/GraphQLParser/AST/GraphQLNamedType.cs

@@ -1,11 +1,12 @@
-namespace GraphQLParser.AST
+namespace GraphQLParser.AST
 {
     public class GraphQLNamedType : GraphQLType, INamedNode
     {
         public override ASTNodeKind Kind => ASTNodeKind.NamedType;
 
         public GraphQLName? Name { get; set; }
 
+        /// <inheritdoc/>
         public override string ToString() => Name?.Value!;
     }
-}
+}

src/GraphQLParser/AST/GraphQLNonNullType.cs

@@ -1,11 +1,12 @@
-namespace GraphQLParser.AST
+namespace GraphQLParser.AST
 {
     public class GraphQLNonNullType : GraphQLType
     {
         public override ASTNodeKind Kind => ASTNodeKind.NonNullType;
 
         public GraphQLType? Type { get; set; }
 
+        /// <inheritdoc/>
         public override string ToString() => Type + "!";
     }
-}
+}

src/GraphQLParser/Token.cs

@@ -1,4 +1,4 @@
-namespace GraphQLParser
+namespace GraphQLParser
 {
     public readonly struct Token
     {
@@ -42,11 +42,12 @@ public Token(TokenKind kind, string? value, int start, int end)
             _ => string.Empty
         };
 
+        /// <inheritdoc/>
         public override string ToString()
         {
             return Value != null
                 ? $"{GetTokenKindDescription(Kind)} \"{Value}\""
                 : GetTokenKindDescription(Kind);
         }
     }
-}
+}