comment for Expression

src/Neo.Compiler.CSharp/MethodConvert/Expression/Expression.cs

@@ -141,7 +141,8 @@ private void ConvertExpression(SemanticModel model, ExpressionSyntax syntax, Syn
             case ImplicitArrayCreationExpressionSyntax expression:
                 ConvertImplicitArrayCreationExpression(model, expression);
                 break;
-            //TODO
+            //Converts an initialValue attribute
+            //Example: [InitialValue("NVg7LjGcUSrgxgjX3zEgqaksfMaiS8Z6e1"]
             case InitializerExpressionSyntax expression:
                 ConvertInitializerExpression(model, expression);
                 break;
@@ -150,7 +151,8 @@ private void ConvertExpression(SemanticModel model, ExpressionSyntax syntax, Syn
             case InterpolatedStringExpressionSyntax expression:
                 ConvertInterpolatedStringExpression(model, expression);
                 break;
-            //TODO
+            //Converts Invocation, include method invocation, event invocation and delegate invocation
+            //Example: Runtime.Log("hello");
             case InvocationExpressionSyntax expression:
                 ConvertInvocationExpression(model, expression);
                 break;

src/Neo.Compiler.CSharp/MethodConvert/Expression/InitializerExpression.cs

@@ -20,6 +20,20 @@ namespace Neo.Compiler;
 
 partial class MethodConvert
 {
+    /// <summary>
+    /// Converts an InitialValue attribute into OpCodes.
+    /// </summary>
+    /// <param name="model">The semantic model providing context and information about InitialValue expression.</param>
+    /// <param name="expression">The syntax representation of the InitialValue expression statement being converted.</param>
+    /// <example>
+    /// Specifies an initial value for a static field within a smart contract,
+    /// Example of initializing a UInt160 field with a Hash160 address
+    /// <code>
+    /// [InitialValue("NVg7LjGcUSrgxgjX3zEgqaksfMaiS8Z6e1", ContractParameterType.Hash160)]
+    /// static readonly UInt160 Owner = default;
+    /// </code>
+    /// </example>
+    /// <seealso href="https://github.com/neo-project/neo-devpack-dotnet/blob/master/src/Neo.SmartContract.Framework/Attributes/InitialValueAttribute.cs">InitialValueAttribute</seealso>
     private void ConvertInitializerExpression(SemanticModel model, InitializerExpressionSyntax expression)
     {
         IArrayTypeSymbol type = (IArrayTypeSymbol)model.GetTypeInfo(expression).ConvertedType!;

src/Neo.Compiler.CSharp/MethodConvert/Expression/InvocationExpression.cs

@@ -21,6 +21,11 @@ namespace Neo.Compiler;
 
 partial class MethodConvert
 {
+    /// <summary>
+    /// Converts Invocation, include method invocation, event invocation and delegate invocation to OpCodes.
+    /// </summary>
+    /// <param name="model">The semantic model providing context and information about invocation expression.</param>
+    /// <param name="expression">The syntax representation of the invocation expression statement being converted.</param>
     private void ConvertInvocationExpression(SemanticModel model, InvocationExpressionSyntax expression)
     {
         ArgumentSyntax[] arguments = expression.ArgumentList.Arguments.ToArray();
@@ -39,6 +44,13 @@ private void ConvertInvocationExpression(SemanticModel model, InvocationExpressi
         }
     }
 
+    /// <summary>
+    /// Convert the event invocation expression to OpCodes.
+    /// </summary>
+    /// <param name="model">The semantic model providing context and information about event invocation expression.</param>
+    /// <param name="symbol">Symbol of the event</param>
+    /// <param name="arguments">Arguments of the event</param>
+    /// <example><see href="https://github.com/neo-project/neo-devpack-dotnet/blob/master/examples/Example.SmartContract.Event/Event.cs"/></example>
     private void ConvertEventInvocationExpression(SemanticModel model, IEventSymbol symbol, ArgumentSyntax[] arguments)
     {
         AddInstruction(OpCode.NEWARRAY0);
@@ -52,6 +64,16 @@ private void ConvertEventInvocationExpression(SemanticModel model, IEventSymbol
         Call(ApplicationEngine.System_Runtime_Notify);
     }
 
+    /// <summary>
+    /// Convert the method invocation expression to OpCodes.
+    /// </summary>
+    /// <param name="model">The semantic model providing context and information about method invocation expression.</param>
+    /// <param name="symbol">Symbol of the method</param>
+    /// <param name="expression">The syntax representation of the method invocation expression statement being converted.</param>
+    /// <param name="arguments">Arguments of the method</param>
+    /// <example>
+    /// <c>Runtime.Log("hello World!");</c>
+    /// </example>
     private void ConvertMethodInvocationExpression(SemanticModel model, IMethodSymbol symbol, ExpressionSyntax expression, ArgumentSyntax[] arguments)
     {
         switch (expression)
@@ -73,6 +95,15 @@ private void ConvertMethodInvocationExpression(SemanticModel model, IMethodSymbo
         }
     }
 
+    /// <summary>
+    /// Convert the delegate invocation expression to OpCodes.
+    /// </summary>
+    /// <param name="model">The semantic model providing context and information about delegate invocation expression.</param>
+    /// <param name="expression">The syntax representation of the delegate invocation expression statement being converted.</param>
+    /// <param name="arguments">Arguments of the delegate</param>
+    /// <example>
+    /// TODO
+    /// </example>
     private void ConvertDelegateInvocationExpression(SemanticModel model, ExpressionSyntax expression, ArgumentSyntax[] arguments)
     {
         INamedTypeSymbol type = (INamedTypeSymbol)model.GetTypeInfo(expression).Type!;