update comments and add example

src/main/scala/com/snowflake/snowpark/functions.scala

@@ -3141,23 +3141,66 @@ object functions {
   def listagg(col: Column): Column = listagg(col, "", isDistinct = false)
 
   /**
-   * Function to convert column name into column and order in a descending manner.
+   * Returns a Column expression with values sorted in descending order.
+   * Example:
+   * {{{
+   *   val df = session.createDataFrame(Seq(1, 2, 3)).toDF("id")
+   *   df.sort(desc("id")).show()
+   *
+   * --------
+   * |"ID"  |
+   * --------
+   * |3     |
+   * |2     |
+   * |1     |
+   * --------
+   * }}}
+ *
    * @since 1.14.0
    * @param colName Column name.
    * @return Column object ordered in a descending manner.
    */
   def desc(colName: String): Column = col(colName).desc
 
   /**
-   * Function to convert column name into column and order in an ascending manner.
+   * Returns a Column expression with values sorted in ascending order.
+   * Example:
+   * {{{
+   *   val df = session.createDataFrame(Seq(3, 2, 1)).toDF("id")
+   *   df.sort(asc("id")).show()
+   *
+   * --------
+   * |"ID"  |
+   * --------
+   * |1     |
+   * |2     |
+   * |3     |
+   * --------
+   * }}}
    * @since 1.14.0
    * @param colName Column name.
    * @return Column object ordered in an ascending manner.
    */
   def asc(colName: String): Column = col(colName).asc
 
   /**
-   * Wrapper for Snowflake built-in size function. Gets the size of array column.
+   * Returns the size of the input ARRAY.
+   *
+   * If the specified column contains a VARIANT value that contains an ARRAY, the size of the ARRAY
+   * is returned; otherwise, NULL is returned if the value is not an ARRAY.
+   *
+   * Example:
+   * {{{
+   *   val df = session.createDataFrame(Seq(Array(1, 2, 3))).toDF("id")
+   *   df.select(size(col("id"))).show()
+   *
+   * ------------------------
+   * |"ARRAY_SIZE(""ID"")"  |
+   * ------------------------
+   * |3                     |
+   * ------------------------
+   * }}}
+   *
    * @since 1.14.0
    * @param c Column to get the size.
    * @return Size of array column.

src/test/scala/com/snowflake/snowpark_test/FunctionSuite.scala

@@ -2201,6 +2201,7 @@ trait FunctionSuite extends TestData {
   }
 
   test("column array size") {
+
     val input = Seq(Array(1, 2, 3)).toDF("size")
     val expected = Seq((3)).toDF("size")
     checkAnswer(input.select(size(col("size"))), expected, sort = false)