Merge pull request #387 from MicrosoftDocs/main639046945286319830sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

query-languages/dax/allselected-function-dax.md

@@ -22,8 +22,8 @@ ALLSELECTED([<tableName> | <columnName>[, <columnName>[, <columnName>[,…]]]] )
 
 |Term|Definition|
 |--------|--------------|
-|`tableName`|The name of an existing table, using standard DAX syntax. This parameter cannot be an expression. This parameter is optional.  |
-|`columnName`|The name of an existing column using standard DAX syntax, usually fully qualified. It cannot be an expression. This parameter is optional.    |
+|`tableName`|The name of an existing table using DAX syntax. This parameter cannot be an expression. This parameter is optional.  |
+|`columnName`|The name of an existing column using DAX syntax, usually fully qualified. It cannot be an expression. This parameter is optional.    |
 
 ## Return value
 

query-languages/dax/distinctcount-function-dax.md

@@ -52,7 +52,21 @@ Using the above measure in a table with calendar year in the side and product ca
 ||||||1|1|
 |**Grand Total**|**1315**|**3153**|**2410**|**2646**|**1**|**3797**|
 
-In the above example, note that the rows Grand Total numbers do not add up, this happens because the same order might contain line items, in the same order, from different product categories.
+### Understanding distinct count totals
+
+Distinct count totals are not additive. The Grand Total is not the sum of the values in each category.
+
+In the table above, you might expect the Grand Total for 2005 (366) to equal the sum of Accessories (135) + Bikes (345) + Clothing (242) + Components (205) = 927. However, the actual Grand Total is 366, which is much lower.
+
+This happens because the same order can appear in multiple categories. For example, if order #1001 contains both a bike and an accessory, that order is counted once in the Bikes column and once in the Accessories column. But when calculating the Grand Total for the row, order #1001 is only counted once because it's still just one distinct order.
+
+This is the correct and expected behavior of distinct counts:
+
+- **Category values**: Count distinct orders within that specific category only.
+- **Row totals**: Count distinct orders across all categories for that year - each order is counted only once, regardless of how many categories it appears in.
+- **Grand Total**: Count distinct orders across the entire dataset.
+
+If you need totals that add up, consider using [COUNT](count-function-dax.md) or [COUNTROWS](countrows-function-dax.md) instead. However, be aware that these functions count rows, not distinct values, and will give different results.
 
 ## Related content
 

query-languages/dax/gcd-function-dax.md

@@ -12,14 +12,14 @@ Returns the greatest common divisor of two or more integers. The greatest common
 ## Syntax
 
 ```dax
-GCD(number1, [number2], ...)
+GCD(number1, number2)
 ```
 
 ### Parameters
 
 |Term|Definition|
 |--------|--------------|
-|`number1, number2, ...`|Number1 is required, subsequent numbers are optional. 1 to 255 values. If any value is not an integer, it is truncated.|
+|`number1, number2`|The two integers for which you want the greatest common divisor. If a value is not an integer, it is truncated.|
 
 ## Return value
 

query-languages/dax/lcm-function-dax.md

@@ -12,14 +12,14 @@ Returns the least common multiple of integers. The least common multiple is the
 ## Syntax
 
 ```dax
-LCM(number1, [number2], ...)
+LCM(number1, number2)
 ```
 
 ### Parameters
 
 |Term|Definition|
 |--------|--------------|
-|`number1, number2,...`|Number1 is required, subsequent numbers are optional. 1 to 255 values for which you want the least common multiple. If value is not an integer, it is truncated.|
+|`number1, number2`|The two integers for which you want the least common multiple. If a value is not an integer, it is truncated.|
 
 ## Return value
 

query-languages/dax/previousyear-function-dax.md

@@ -7,9 +7,9 @@ ms.topic: reference
 
 [!INCLUDE[applies-to-measures-columns-tables-visual-calculations-discouraged](includes/applies-to-measures-columns-tables-visual-calculations-discouraged.md)]
 
-For date column input, Returns a table that contains a column of all dates from the previous year, given the last date in the `dates` column, in the current context.
+For date column input, returns a table that contains a column of all dates from the previous year, based on the first date in the `dates` column, in the current context.
 
-For calendar input, returns all dates from the previous year, based on the first date in the current context. The table contains all primary tagged columns and all time related columns
+For calendar input, returns all dates from the previous year, based on the first date in the current context. The table contains all primary tagged columns and all time related columns.
 
 ## Syntax
 
@@ -31,7 +31,7 @@ For calendar input, a table that contains all primary tagged columns and all tim
 
 ## Remarks
 
-- This function returns all dates from the previous year given the latest date in the input parameter. For example, if the latest date in the `dates` argument refers to the year 2009, then this function returns all dates for the year of 2008, up to the specified `year_end_date`.
+- This function returns all dates from the previous year based on the first date in the input parameter. For example, if the first date in the `dates` argument refers to the year 2009, then this function returns all dates for the year of 2008, up to the specified `year_end_date`.
 
 - The `dates` argument can be any of the following:
   - A reference to a date/time column.

query-languages/dax/time-intelligence-functions-dax.md

@@ -28,11 +28,11 @@ Data Analysis Expressions (DAX) includes time-intelligence functions that enable
 |[ENDOFYEAR](endofyear-function-dax.md)     | Returns the last date of the year in the current context for the specified column of dates.        |
 |[FIRSTDATE](firstdate-function-dax.md)     | Returns the first date in the current context for the specified column of dates.         |
 |[LASTDATE](lastdate-function-dax.md)      |  Returns the last date in the current context for the specified column of dates.       |
-|[NEXTDAY](nextday-function-dax.md)      |  Returns a table that contains a column of all dates from the next day, based on the first date specified in the dates column in the current context.       |
-|[NEXTWEEK](nextweek-function-dax.md)     |  Returns a table that contains a column of all dates from the next week, based on the first date in the dates column in the current context.  |
-|[NEXTMONTH](nextmonth-function-dax.md)     |  Returns a table that contains a column of all dates from the next month, based on the first date in the dates column in the current context.       |
-|[NEXTQUARTER](nextquarter-function-dax.md)     |  Returns a table that contains a column of all dates in the next quarter, based on the first date specified in the dates column, in the current context.        |
-|[NEXTYEAR](nextyear-function-dax.md)      | Returns a table that contains a column of all dates in the next year, based on the first date in the dates column, in the current context.          |
+|[NEXTDAY](nextday-function-dax.md)      |  Returns a table that contains a column of all dates from the next day, based on the last date specified in the dates column in the current context.       |
+|[NEXTWEEK](nextweek-function-dax.md)     |  Returns a table that contains a column of all dates from the next week, based on the last date in the dates column in the current context.  |
+|[NEXTMONTH](nextmonth-function-dax.md)     |  Returns a table that contains a column of all dates from the next month, based on the last date in the dates column in the current context.       |
+|[NEXTQUARTER](nextquarter-function-dax.md)     |  Returns a table that contains a column of all dates in the next quarter, based on the last date specified in the dates column, in the current context.        |
+|[NEXTYEAR](nextyear-function-dax.md)      | Returns a table that contains a column of all dates in the next year, based on the last date in the dates column, in the current context.          |
 |[OPENINGBALANCEWEEK](openingbalanceweek-function-dax.md)     | Evaluates the expression at the first date of the week in the current context.         |
 |[OPENINGBALANCEMONTH](openingbalancemonth-function-dax.md)     | Evaluates the expression at the first date of the month in the current context.         |
 |[OPENINGBALANCEQUARTER](openingbalancequarter-function-dax.md)     | Evaluates the expression at the first date of the quarter, in the current context.         |
@@ -42,7 +42,7 @@ Data Analysis Expressions (DAX) includes time-intelligence functions that enable
 |[PREVIOUSWEEK](previousweek-function-dax.md)      | Returns a table that contains a column of all dates representing the week that is previous to the first date in the dates column, in the current context.        |
 |[PREVIOUSMONTH](previousmonth-function-dax.md)     |  Returns a table that contains a column of all dates from the previous month, based on the first date in the dates column, in the current context.       |
 |[PREVIOUSQUARTER](previousquarter-function-dax.md)      |  Returns a table that contains a column of all dates from the previous quarter, based on the first date in the dates column, in the current context.       |
-|[PREVIOUSYEAR](previousyear-function-dax.md)       |  Returns a table that contains a column of all dates from the previous year, given the last date in the dates column, in the current context.        |
+|[PREVIOUSYEAR](previousyear-function-dax.md)       |  Returns a table that contains a column of all dates from the previous year, based on the first date in the dates column, in the current context.        |
 |[SAMEPERIODLASTYEAR](sameperiodlastyear-function-dax.md)     |  Returns a table that contains a column of dates shifted one year back in time from the dates in the specified dates column, in the current context.       |
 |[STARTOFWEEK](startofweek-function-dax.md)     | Returns the first date of the week in the current context for the specified column of dates.          |
 |[STARTOFMONTH](startofmonth-function-dax.md)     | Returns the first date of the month in the current context for the specified column of dates.          |

query-languages/dax/today-function-dax.md

@@ -21,11 +21,11 @@ A date (`datetime`).
 
 ## Remarks
 
-- The TODAY function is useful when you need to have the current date displayed on a worksheet, regardless of when you open the workbook. It is also useful for calculating intervals.
+- The TODAY function is useful when you need to have the current date displayed in a report, regardless of when you open it. It is also useful for calculating intervals.
 
-- If the TODAY function does not update the date when you expect it to, you might need to change the settings that control when the column or workbook is refreshed..
+- If the TODAY function does not update the date when you expect it to, you might need to change the settings that control when the report or semantic model is refreshed.
 
-- The NOW function is similar but returns the exact time, whereas TODAY returns the time value 12:00:00 PM for all dates.
+- The NOW function is similar but returns the exact time, whereas TODAY returns the time value 12:00:00 AM (midnight) for all dates.
 
 ## Example
 

query-languages/dax/treatas-function-dax.md

@@ -12,7 +12,7 @@ Applies the result of a table expression as filters to columns from an unrelated
 ## Syntax
 
 ```dax
-TREATAS(table_expression, <column>[, <column>[, <column>[,…]]]} )
+TREATAS(table_expression, <column>[, <column>[, <column>[,…]]])
 ```
 
 ### Parameters