docs: DOC-1227: Core desync - batch of updates (deephaven#7845)

Author: elijahpetty

docs/groovy/conceptual/query-table-configuration.md

@@ -204,12 +204,12 @@ The recycler capacity determines how many array blocks are kept in memory for po
 
 ## Stateless by default
 
-In a future release of Deephaven, the flags in this category will change from a default of false to a default of true. These flags enable the engine to assume more often that a given Filter or Selectable can be executed in parallel (unless the Filter or Selectable is [marked serial or has barriers](./query-engine/parallelization.md#controlling-concurrency-for-select-update-and-where) interface).
+These flags enable the engine to assume more often that a given Filter or Selectable can be executed in parallel (unless the Filter or Selectable is [marked serial or has barriers](./query-engine/parallelization.md#controlling-concurrency-for-select-update-and-where) interface).
 
 | Property Name                          | Default Value | Description                                                                                             |
 | -------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
-| `QueryTable.statelessFiltersByDefault` | false         | Enables the engine to assume that filters are stateless by default, allowing for more optimizations     |
-| `QueryTable.statelessSelectByDefault`  | false         | Enables the engine to assume that Selectables are stateless by default, allowing for more optimizations |
+| `QueryTable.statelessFiltersByDefault` | true          | Enables the engine to assume that filters are stateless by default, allowing for more optimizations     |
+| `QueryTable.statelessSelectByDefault`  | true          | Enables the engine to assume that Selectables are stateless by default, allowing for more optimizations |
 
 ## Related documentation
 

docs/groovy/how-to-guides/install-use-plugins.md

@@ -2,14 +2,16 @@
 title: Install and use plugins
 ---
 
-There are many ways to customize either the Deephaven build or packages to fit your use-cases. In this guide, we extend Deephaven to build a custom Docker image with JS plugins installed. For this guide, we will add the `js-plugin-matplotlib`. This makes the popular [Matplotlib](https://matplotlib.org/) library available for use, providing more data visualization options within the Deephaven IDE, such as 3D plots and sophisticated scatter plots. As always, you'll be able to plot both your static and real-time data.
+This guide covers the installation and use of plugins in Deephaven. A plugin is something that extends the functionality of a software. Groovy packages are a common example of plugins - they extend Groovy's capabilities. Plugins in Deephaven can extend the functionality of a running server, UI, client API, or all of them.
 
-Plugins in Deephaven can extend the functionality of a running server, UI, client API, or all of them. Deephaven offers several pre-built plugins that can extend the platform's functionality. These are available to anyone using Deephaven Community Core.
+Deephaven offers several pre-built plugins that can extend the platform's functionality. These are available to anyone using Deephaven Community Core. They can be installed easily and provide a range of additional capabilities. For the full list of available plugins, see [available plugins](#available-plugins).
 
 Server-side plugins extend the functionality of the Deephaven server. For instance, plotting plugins add the ability to plot with new APIs such as Plotly Express, Matplotlib, and Seaborn. Authentication plugins add the ability to authenticate users with new authentication methods such as mTLS.
 
 Client-side plugins extend the functionality of any of Deephaven's client APIs. For instance, the Groovy client API can be extended with plugins that allow the client to manage arbitrary objects in the server, or to interact with the server using a different serialization format.
 
+Other plugins may have both a server-side plugin and a client-side plugin, allowing bidirectional communication between the client and server.
+
 > [!NOTE]
 > In some cases, you'll want to install packages rather than use plugins. Those instructions are covered in [How to install packages](./install-packages.md).
 >

docs/groovy/how-to-guides/ternary-if-how-to.md

@@ -3,9 +3,27 @@ title: Use the ternary conditional operator in query strings
 sidebar_label: Ternary-if
 ---
 
-Groovy's native ternary operator (`condition ? valueIfTrue : valueIfFalse`) works seamlessly in Deephaven query strings, providing a concise way to implement conditional logic.
+This guide will show you how to use Groovy's native ternary operator (`condition ? valueIfTrue : valueIfFalse`), also known as ternary-if, in query strings. The operator evaluates a boolean expression and returns the result of one of two expressions, depending on whether the boolean expression evaluates to true or false. It is similar to an inline `if-then-else` code block.
 
-## Basic usage
+## Ternary conditional operator (ternary-if)
+
+The syntax for the ternary conditional operator is:
+`condition ? expressionIfTrue : expressionIfFalse`
+
+The question mark (`?`) separates the condition from the expressions, and the colon (`:`) separates the expression evaluated when the condition is true from the expression evaluated when the condition is false.
+
+The expression `x ? y : z` evaluates as follows:
+
+- If `x` is true, the expression evaluates to `y`.
+- If `x` is false, the expression evaluates to `z`.
+
+The expression `x ? (y ? 1 : 2) : 3` evaluates as follows:
+
+- If both `x` and `y` are true, the expression evaluates to 1.
+- If `x` is true, and `y` is false, the expression evaluates to 2.
+- If `x` is false, the expression evaluates to 3.
+
+In the following example, a new column, `Budget`, is created. The column contains `yes` if the value in the `Price` column is less than or equal to 3.50 and `no` otherwise.
 
 ```groovy order=woods,result
 woods = newTable(
@@ -16,9 +34,21 @@ woods = newTable(
 result = woods.update("Budget = (Price <= 3.50) ? `yes` : `no`")
 ```
 
-## Nested ternary operators
+## Nested ternary conditional operators
+
+For more complex cases with multiple conditions, ternary-if statements can be nested. For example:
+
+`condition1 ? (condition2 ? value1 : value2) : value3`
+
+The expression `x ? (y ? 1 : 2) : 3` evaluates as follows:
+
+- If both `x` and `y` are true, the expression evaluates to 1.
+- If `x` is true, and `y` is false, the expression evaluates to 2.
+- If `x` is false, the expression evaluates to 3.
 
-Ternary operators can be nested for more complex conditional logic:
+Consider a home builder with a budget of $3.50/board-foot to purchase hardwood lumber. The builder would like to know what types of wood are within their budget. Nested ternary operators can create `yes` and `no` values based on whether or not a type of wood meets this requirement.
+
+In this example, the `Possible` column evaluates to `yes` only if the wood is both hardwood and the price is less than $3.50. Otherwise, the wood is not offered as a possibility for the customer.
 
 ```groovy test-set=1 order=woods,result
 woods = newTable(
@@ -27,25 +57,30 @@ woods = newTable(
     doubleCol("Price", 1.95, 2.50, 3.25, 3.45, 4.25, 7.95, 4.10, 5.25)
 )
 
-result = woods.update("Category = (Hardness == `hard`) ? ((Price <= 3.50) ? `budget` : `expensive`) : `softwood`")
+result = woods.update("Possible = (Hardness == `hard`) ? ((Price <= 3.50) ? `yes` : `no`) : `no`")
+```
+
+If hardwood is a requirement but the budget is flexible, nested ternary-ifs can be used to categorize hardwoods as `budget` or `expensive` and all other wood types as `no`. This is seen below:
+
+```groovy test-set=1
+result = woods.update("possible = (Hardness == `hard`) ? ((Price <= 3.50) ? `budget` : `expensive`) : `no`")
 ```
 
 ## Using custom methods
 
-When using custom methods as conditions, [cast](./casting.md) the result to `(Boolean)`:
+Using a function in a ternary statement is very straightforward. All you need to do is replace the `condition` with the function call. The method _must_ return a `(Boolean)` value.
 
-```groovy order=woods,result
-budget = { price -> price <= 3.50 }
+The following example uses a function in a ternary operator to determine if the wood flooring options are in the budget.
 
-woods = newTable(
-    stringCol("Type", "Pine", "Fir", "Cedar", "Oak", "Ash", "Walnut", "Beech", "Cherry"),
-    doubleCol("Price", 1.95, 2.50, 3.25, 3.45, 4.25, 7.95, 4.10, 5.25)
-)
+```groovy test-set=1
+budget = { price -> price <= 3.50 }
 
 result = woods.update("Budget = (Boolean)budget(Price) ? `yes` : `no`")
 ```
 
 ## Related documentation
 
+- [Operators](./operators.md)
+- [`new_table`](../reference/table-operations/create/newTable.md)
+- [`update`](../reference/table-operations/select/update.md)
 - [Query string overview](./query-string-overview.md)
-- [Create a new table](./new-and-empty-table.md#newtable)

docs/groovy/snapshots/2bc4f0a1e18cc7c139de94f7864c803a.json

@@ -0,0 +1 @@
+{"file":"how-to-guides/ternary-if-how-to.md","objects":{"result":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"},{"name":"Budget","type":"java.lang.String"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"},{"value":"yes"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"},{"value":"yes"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"},{"value":"yes"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"},{"value":"yes"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"},{"value":"no"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"},{"value":"no"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"},{"value":"no"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"},{"value":"no"}]]}}}}

docs/groovy/snapshots/5c652ea4a33beef5f45cd4f5410958da.json

@@ -1 +1 @@
-{"file":"how-to-guides/ternary-if-how-to.md","objects":{"woods":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"}]]}},"result":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"},{"name":"Category","type":"java.lang.String"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"},{"value":"softwood"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"},{"value":"softwood"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"},{"value":"softwood"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"},{"value":"budget"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"},{"value":"expensive"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"},{"value":"expensive"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"},{"value":"expensive"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"},{"value":"expensive"}]]}}}}
+{"file":"how-to-guides/ternary-if-how-to.md","objects":{"woods":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"}]]}},"result":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"},{"name":"Possible","type":"java.lang.String"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"},{"value":"no"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"},{"value":"no"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"},{"value":"no"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"},{"value":"yes"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"},{"value":"no"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"},{"value":"no"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"},{"value":"no"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"},{"value":"no"}]]}}}}

…ts/996bd94985c7585ed16008d3845ef0f9.json …ts/81e850d235e0c8facda7ed20cd058c8e.jsondocs/groovy/snapshots/996bd94985c7585ed16008d3845ef0f9.json renamed to docs/groovy/snapshots/81e850d235e0c8facda7ed20cd058c8e.json docs/groovy/snapshots/996bd94985c7585ed16008d3845ef0f9.json renamed to docs/groovy/snapshots/81e850d235e0c8facda7ed20cd058c8e.json

@@ -0,0 +1 @@
+{"file":"how-to-guides/ternary-if-how-to.md","objects":{"result":{"type":"Table","data":{"columns":[{"name":"Type","type":"java.lang.String"},{"name":"Hardness","type":"java.lang.String"},{"name":"Price","type":"double"},{"name":"possible","type":"java.lang.String"}],"rows":[[{"value":"Pine"},{"value":"soft"},{"value":"1.9500"},{"value":"no"}],[{"value":"Fir"},{"value":"soft"},{"value":"2.5000"},{"value":"no"}],[{"value":"Cedar"},{"value":"soft"},{"value":"3.2500"},{"value":"no"}],[{"value":"Oak"},{"value":"hard"},{"value":"3.4500"},{"value":"budget"}],[{"value":"Ash"},{"value":"hard"},{"value":"4.2500"},{"value":"expensive"}],[{"value":"Walnut"},{"value":"hard"},{"value":"7.9500"},{"value":"expensive"}],[{"value":"Beech"},{"value":"hard"},{"value":"4.1000"},{"value":"expensive"}],[{"value":"Cherry"},{"value":"hard"},{"value":"5.2500"},{"value":"expensive"}]]}}}}

docs/groovy/snapshots/cc805f03ac22f4f8758a57b4c3af8893.json

@@ -34,7 +34,7 @@ The `QueryTable` has the following user-configurable properties:
 | [Ungroup operations](#ungroup-operations)                           | `QueryTable.minimumUngroupBase`                          | 10         |
 | [SoftRecycler configuration](#softrecycler-configuration)           | `array.recycler.capacity.*`                              | 1024       |
 | [SoftRecycler configuration](#softrecycler-configuration)           | `sparsearray.recycler.capacity.*`                        | 1024       |
-| [Stateless filters by default](#stateless-by-default-experimental)  | `QueryTable.statelessFiltersByDefault`                   | false      |
+| [Stateless filters by default](#stateless-by-default)               | `QueryTable.statelessFiltersByDefault`                   | false      |
 
 Each property is described below, roughly categorized by similarity.
 
@@ -204,15 +204,13 @@ The recycler capacity determines how many array blocks are kept in memory for po
 - **High throughput environments**: Consider increasing capacities to reduce allocation/deallocation overhead.
 - **Type-specific tuning**: If certain types are used more frequently, you can increase their capacity while reducing others.
 
-## Stateless by default (experimental)
+## Stateless by default
 
-In a future release of Deephaven, the flags in this category will change from a default of false to a default of true. These flags enable the engine to assume more often that a given Filter or Selectable can be executed in parallel (unless the Filter or Selectable is [marked serial or has barriers](./query-engine/parallelization.md#controlling-concurrency-for-select-update-and-where) interface).
-
-This is experimental; more details can be learned by reading the Javadoc on io.deephaven.api.ConcurrencyControl.
+These flags enable the engine to assume more often that a given Filter or Selectable can be executed in parallel (unless the Filter or Selectable is [marked serial or has barriers](./query-engine/parallelization.md#controlling-concurrency-for-select-update-and-where) interface).
 
 | Property Name                          | Default Value | Description                                                                                         |
 | -------------------------------------- | ------------- | --------------------------------------------------------------------------------------------------- |
-| `QueryTable.statelessFiltersByDefault` | false         | Enables the engine to assume that filters are stateless by default, allowing for more optimizations |
+| `QueryTable.statelessFiltersByDefault` | true          | Enables the engine to assume that filters are stateless by default, allowing for more optimizations |
 
 ## Related documentation
 

docs/python/conceptual/query-table-configuration.md

@@ -7,7 +7,7 @@ Deephaven query strings are the primary way of expressing commands directly to t
 
 ## Syntax
 
-Query strings are just Python strings that get passed into table operations.
+Query strings are just Python strings that get passed into table operations. Deephaven **highly** recommends using double quotes to encapsulate query strings.
 
 ```python test-set=1
 from deephaven import empty_table

docs/python/getting-started/crash-course/query-strings.md

@@ -12,6 +12,11 @@ Client-side plugins extend the functionality of any of Deephaven's client APIs.
 
 Other plugins may have both a server-side plugin and a client-side plugin. The [Pickle RPC plugin](https://github.com/deephaven-examples/plugin-python-rpc-pickle) is one such example. It allows a client to make RPC calls on a server.
 
+> [!NOTE]
+> In some cases, you'll want to install packages rather than use plugins. Those instructions are covered in [How to install packages](./install-packages.md).
+>
+> To have _complete control_ of the build process, you can [Build and launch Deephaven from source code](../getting-started/launch-build.md).
+
 This guide covers the installation and use of pre-built plugins. For information on building your own plugins, see [Create your own plugin](./create-plugins.md).
 
 ## Install a plugin