docs devsite update

MarkDuckworth · MarkDuckworth · commit e77481ca3fac · 2026-03-10T15:45:06.000-06:00
diff --git a/docs-devsite/firestore_lite_pipelines.booleanexpression.md b/docs-devsite/firestore_lite_pipelines.booleanexpression.md
@@ -127,7 +127,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 ```typescript
 // Create an expression that protects against a divide by zero error
 // but always returns a boolean expression.
-constant(50).divide('length').gt(1).ifError(constant(false));
+constant(50).divide(field('length')).greaterThan(1).ifError(constant(false));
 
 ```
 
@@ -162,7 +162,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 ```typescript
 // Create an expression that protects against a divide by zero error
 // but always returns a boolean expression.
-constant(50).divide('length').gt(1).ifError(false);
+constant(50).divide(field('length')).greaterThan(1).ifError(false);
 
 ```
 
@@ -196,7 +196,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create an expression that protects against a divide by zero error.
-constant(50).divide('length').gt(1).ifError(constant(0));
+constant(50).divide(field('length')).greaterThan(1).ifError(constant(0));
 
 ```
 
@@ -230,7 +230,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create an expression that protects against a divide by zero error.
-constant(50).divide('length').gt(1).ifError(0);
+constant(50).divide(field('length')).greaterThan(1).ifError(0);
 
 ```
 
diff --git a/docs-devsite/firestore_lite_pipelines.expression.md b/docs-devsite/firestore_lite_pipelines.expression.md
@@ -1389,7 +1389,7 @@ A new `Ordering` for ascending sorting.
 
 ```typescript
 // Sort documents by the 'name' field in ascending order
-pipeline().collection("users")
+firestore.pipeline().collection("users")
   .sort(field("name").ascending());
 
 ```
@@ -2043,7 +2043,7 @@ A new `Expression` representing the 'IN' comparison.
 
 ```typescript
 // Check if the 'category' field is either "Electronics" or value of field 'primaryType'
-field("category").equalAny("Electronics", field("primaryType"));
+field("category").equalAny(["Electronics", field("primaryType")]);
 
 ```
 
@@ -2557,7 +2557,6 @@ A new [BooleanExpression](./firestore_pipelines.booleanexpression.md#booleanexpr
 ```typescript
 // Check if the field `value` is absent.
 field("value").isAbsent();
-@example
 
 ```
 
@@ -3038,7 +3037,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Returns the larger value between the 'timestamp' field and the current timestamp.
-field("timestamp").logicalMaximum(Function.currentTimestamp());
+field("timestamp").logicalMaximum(currentTimestamp());
 
 ```
 
@@ -3073,7 +3072,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Returns the smaller value between the 'timestamp' field and the current timestamp.
-field("timestamp").logicalMinimum(Function.currentTimestamp());
+field("timestamp").logicalMinimum(currentTimestamp());
 
 ```
 
@@ -4239,7 +4238,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Split the 'scores' field on delimiter ',' or ':' depending on the stored format
-field('scores').split(conditional(field('format').equal('csv'), constant(','), constant(':'))
+field('scores').split(conditional(field('format').equal('csv'), constant(','), constant(':')))
 
 ```
 
diff --git a/docs-devsite/firestore_lite_pipelines.md b/docs-devsite/firestore_lite_pipelines.md
@@ -2024,7 +2024,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create an array value from the input array and reference the 'baz' field value from the input document.
-array(['bar', Field.of('baz')]).as('foo');
+array(['bar', field('baz')]).as('foo');
 
 ```
 
@@ -2058,7 +2058,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create a map from the input object and reference the 'baz' field value from the input document.
-map({foo: 'bar', baz: Field.of('baz')}).as('data');
+map({foo: 'bar', baz: field('baz')}).as('data');
 
 ```
 
@@ -3634,7 +3634,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Split the 'scores' field on delimiter ',' or ':' depending on the stored format
-split(field('scores'), conditional(field('format').equal('csv'), constant(','), constant(':'))
+split(field('scores'), conditional(field('format').equal('csv'), constant(','), constant(':')))
 
 ```
 
@@ -4086,7 +4086,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Reverse the value of the 'myString' field.
-strReverse("myString");
+stringReverse("myString");
 
 ```
 
@@ -5250,7 +5250,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Get the character length of the 'name' field in UTF-8.
-strLength("name");
+charLength("name");
 
 ```
 
@@ -7527,7 +7527,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Split the 'scores' field on delimiter ',' or ':' depending on the stored format
-split('scores', conditional(field('format').equal('csv'), constant(','), constant(':'))
+split('scores', conditional(field('format').equal('csv'), constant(','), constant(':')))
 
 ```
 
@@ -9330,7 +9330,7 @@ A new `Expression` representing the greater than comparison.
 
 ```typescript
 // Check if the 'age' field is greater than 18
-greaterThan(field("age"), Constant(9).add(9));
+greaterThan(field("age"), constant(9).add(9));
 
 ```
 
@@ -10193,7 +10193,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Get the character length of the 'name' field in UTF-8.
-strLength(field("name"));
+charLength(field("name"));
 
 ```
 
@@ -10829,7 +10829,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Reverse the value of the 'myString' field.
-strReverse(field("myString"));
+stringReverse(field("myString"));
 
 ```
 
@@ -10897,7 +10897,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Convert the 'title' field to uppercase
-toUppercase(field("title"));
+toUpper(field("title"));
 
 ```
 
@@ -11195,7 +11195,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 ```typescript
 // Create an expression that protects against a divide by zero error
 // but always returns a boolean expression.
-ifError(constant(50).divide('length').gt(1), constant(false));
+ifError(constant(50).divide(field('length')).greaterThan(1), constant(false));
 
 ```
 
diff --git a/docs-devsite/firestore_lite_pipelines.pipeline.md b/docs-devsite/firestore_lite_pipelines.pipeline.md
@@ -120,7 +120,7 @@ A new Pipeline object with this stage appended to the stage list.
 firestore.pipeline().collection("books")
   .addFields(
     field("rating").as("bookRating"), // Rename 'rating' to 'bookRating'
-    add(5, field("quantity")).as("totalCost")  // Calculate 'totalCost'
+    add(field("quantity"), 5).as("totalCost")  // Calculate 'totalCost'
   );
 
 ```
@@ -165,7 +165,7 @@ A new Pipeline object with this stage appended to the stage list.
 firestore.pipeline().collection("books")
   .addFields(
     field("rating").as("bookRating"), // Rename 'rating' to 'bookRating'
-    add(5, field("quantity")).as("totalCost")  // Calculate 'totalCost'
+    add(field("quantity"), 5).as("totalCost")  // Calculate 'totalCost'
   );
 
 ```
@@ -207,7 +207,7 @@ A new Pipeline object with this stage appended to the stage list.
 // Calculate the average rating and the total number of books
 firestore.pipeline().collection("books")
     .aggregate(
-        field("rating").avg().as("averageRating"),
+        field("rating").average().as("averageRating"),
         countAll().as("totalBooks")
     );
 
@@ -251,7 +251,7 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 // Calculate the average rating for each genre.
 firestore.pipeline().collection("books")
   .aggregate({
-      accumulators: [avg(field("rating")).as("avg_rating")]
+      accumulators: [average(field("rating")).as("avg_rating")],
       groups: ["genre"]
       });
 
@@ -297,7 +297,7 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 ```typescript
 // Get a list of unique author names in uppercase and genre combinations.
 firestore.pipeline().collection("books")
-    .distinct(toUppercase(field("author")).as("authorName"), field("genre"), "publishedAt")
+    .distinct(toUpper(field("author")).as("authorName"), field("genre"), "publishedAt")
     .select("authorName");
 
 ```
@@ -341,7 +341,7 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 ```typescript
 // Get a list of unique author names in uppercase and genre combinations.
 firestore.pipeline().collection("books")
-    .distinct(toUppercase(field("author")).as("authorName"), field("genre"), "publishedAt")
+    .distinct(toUpper(field("author")).as("authorName"), field("genre"), "publishedAt")
     .select("authorName");
 
 ```
@@ -594,7 +594,7 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 ```typescript
 // Assume we don't have a built-in 'where' stage
 firestore.pipeline().collection('books')
-    .rawStage('where', [field('published').lt(1900)]) // Custom 'where' stage
+    .rawStage('where', [field('published').lessThan(1900)]) // Custom 'where' stage
     .select('title', 'author');
 
 ```
@@ -971,7 +971,7 @@ db.pipeline().collection("books")
   .select(
     "firstName",
     field("lastName"),
-    field("address").toUppercase().as("upperAddress"),
+    field("address").toUpper().as("upperAddress"),
   );
 
 ```
@@ -1017,7 +1017,7 @@ db.pipeline().collection("books")
   .select(
     "firstName",
     field("lastName"),
-    field("address").toUppercase().as("upperAddress"),
+    field("address").toUpper().as("upperAddress"),
   );
 
 ```
@@ -1060,8 +1060,8 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 // with the same rating
 firestore.pipeline().collection("books")
     .sort(
-        Ordering.of(field("rating")).descending(),
-        Ordering.of(field("title"))  // Ascending order is the default
+        field("rating").descending(),
+        field("title").ascending()
     );
 
 ```
@@ -1103,8 +1103,8 @@ A new [Pipeline](./firestore_pipelines.pipeline.md#pipeline_class) object with t
 // with the same rating
 firestore.pipeline().collection("books")
     .sort(
-        Ordering.of(field("rating")).descending(),
-        Ordering.of(field("title"))  // Ascending order is the default
+        field("rating").descending(),
+        field("title").ascending()
     );
 
 ```
@@ -1328,8 +1328,8 @@ A new Pipeline object with this stage appended to the stage list.
 firestore.pipeline().collection("books")
   .where(
     and(
-        gt(field("rating"), 4.0),   // Filter for ratings greater than 4.0
-        field("genre").eq("Science Fiction") // Equivalent to gt("genre", "Science Fiction")
+        greaterThan(field("rating"), 4.0),   // Filter for ratings greater than 4.0
+        field("genre").equal("Science Fiction") // Equivalent to equal("genre", "Science Fiction")
     )
   );
 
@@ -1373,8 +1373,8 @@ A new Pipeline object with this stage appended to the stage list.
 firestore.pipeline().collection("books")
   .where(
     and(
-        gt(field("rating"), 4.0),   // Filter for ratings greater than 4.0
-        field("genre").eq("Science Fiction") // Equivalent to gt("genre", "Science Fiction")
+        greaterThan(field("rating"), 4.0),   // Filter for ratings greater than 4.0
+        field("genre").equal("Science Fiction") // Equivalent to equal("genre", "Science Fiction")
     )
   );
 
@@ -1394,13 +1394,13 @@ const results1 = await execute(db.pipeline()
 // Example 2: Filter documents where 'genre' is "Science Fiction" and 'published' is after 1950
 const results2 = await execute(db.pipeline()
     .collection("books")
-    .where(and(field("genre").eq("Science Fiction"), field("published").gt(1950))));
+    .where(and(field("genre").equal("Science Fiction"), field("published").greaterThan(1950))));
 
 // Example 3: Calculate the average rating of books published after 1980
 const results3 = await execute(db.pipeline()
     .collection("books")
-    .where(field("published").gt(1980))
-    .aggregate(avg(field("rating")).as("averageRating")));
+    .where(field("published").greaterThan(1980))
+    .aggregate(average(field("rating")).as("averageRating")));
 
 ```
 
diff --git a/docs-devsite/firestore_pipelines.booleanexpression.md b/docs-devsite/firestore_pipelines.booleanexpression.md
@@ -127,7 +127,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 ```typescript
 // Create an expression that protects against a divide by zero error
 // but always returns a boolean expression.
-constant(50).divide('length').gt(1).ifError(constant(false));
+constant(50).divide(field('length')).greaterThan(1).ifError(constant(false));
 
 ```
 
@@ -162,7 +162,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 ```typescript
 // Create an expression that protects against a divide by zero error
 // but always returns a boolean expression.
-constant(50).divide('length').gt(1).ifError(false);
+constant(50).divide(field('length')).greaterThan(1).ifError(false);
 
 ```
 
@@ -196,7 +196,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create an expression that protects against a divide by zero error.
-constant(50).divide('length').gt(1).ifError(constant(0));
+constant(50).divide(field('length')).greaterThan(1).ifError(constant(0));
 
 ```
 
@@ -230,7 +230,7 @@ A new [Expression](./firestore_pipelines.expression.md#expression_class) represe
 
 ```typescript
 // Create an expression that protects against a divide by zero error.
-constant(50).divide('length').gt(1).ifError(0);
+constant(50).divide(field('length')).greaterThan(1).ifError(0);
 
 ```
 
diff --git a/docs-devsite/firestore_pipelines.expression.md b/docs-devsite/firestore_pipelines.expression.md
diff --git a/docs-devsite/firestore_pipelines.md b/docs-devsite/firestore_pipelines.md
