Move koda_v1_api_reference to api_reference.

PiperOrigin-RevId: 718293671
Change-Id: I24bf9168fe8c5c2f894ac8ccb9fc826668cded7a

Author: timofey-stepanov

docs/_data/navigation.yml

@@ -8,4 +8,4 @@ items:
   - title: "Cheatsheet"
     url: "cheatsheet.html"
   - title: "API Reference"
-    url: "koda_v1_api_reference.html"
+    url: "api_reference.html"

docs/koda_v1_api_reference.md docs/api_reference.mddocs/koda_v1_api_reference.md renamed to docs/api_reference.md

@@ -1675,7 +1675,7 @@ Example:
   kd.call(kd.fn(I.x + I.y), x=2, y=3)
   # returns kd.item(5)
 
-  kde.call(I.fn, x=2, y=3).eval(fn=kd.fn(I.x + I.y))
+  kd.lazy.call(I.fn, x=2, y=3).eval(fn=kd.fn(I.x + I.y))
   # returns kd.item(5)
 
 Args:
@@ -5957,11 +5957,16 @@ slicing argument can be one of the following:
   1) INT32/INT64 DataItem or Python integer wrapped into INT32 DataItem. It is
      used to select a single item in one dimension. It reduces the number of
      dimensions in the resulting DataSlice by 1.
-  2) INT32/INT64 DataSlice or Python nested list of integer wrapped into INT32
-     DataSlice. It is used to select multiple items in one dimension.
+  2) INT32/INT64 DataSlice. It is used to select multiple items in one
+  dimension.
   3) Python slice (e.g. slice(1), slice(1, 3), slice(2, -1)). It is used to
      select a slice of items in one dimension. 'step' is not supported and it
-     results in no item if 'start' is larger than or equal to 'stop'.
+     results in no item if 'start' is larger than or equal to 'stop'. 'start'
+     and 'stop' can be either Python integers, DataItems or DataSlices, in
+     the latter case we can select a different range for different items,
+     or even select multiple ranges for the same item if the 'start'
+     or 'stop' have more dimensions. If an item is missing either in 'start'
+     or in 'stop', the corresponding slice is considered empty.
   4) .../Ellipsis. It can appear at most once in `slices` and used to fill
      corresponding dimensions in `x` but missing in `slices`. It means
      selecting all items in these dimensions.
@@ -6030,6 +6035,17 @@ Example 11:
   kd.subslice(x, 1, 2, 3, 4)
     => error as at most 3 slicing arguments can be provided
 
+Example 12:
+  x = kd.slice([[[1, 2], [3]], [[4, 5, 6]], [[7], [8, 9]]])
+  kd.subslice(x, slice(kd.slice([0, 1, 2]), None))
+    => kd.slice([[[1, 2], [3]], [[5, 6]], [[], []]])
+
+Example 13:
+  x = kd.slice([[[1, 2], [3]], [[4, 5, 6]], [[7], [8, 9]]])
+  kd.subslice(x, slice(kd.slice([0, 1, 2]), kd.slice([2, 3, None])), ...)
+    => kd.slice([[[[1, 2], [3]], [[4, 5, 6]]], [[[4, 5, 6]], [[7], [8, 9]]],
+    []])
+
 Note that there is a shortcut `ds.S[*slices] for this operator which is more
 commonly used and the Python slice can be written as [start:end] format. For
 example:
@@ -6861,13 +6877,24 @@ Args:
     range [0, len(x)).
 ```
 
+### `kd.tuple.make_slice(start=unspecified, stop=unspecified, step=unspecified)` {#kd.tuple.make_slice}
+
+``` {.no-copy}
+Returns a slice for the Python indexing syntax foo[start:stop:step].
+
+Args:
+  start: (optional) Indexing start.
+  stop: (optional) Indexing stop.
+  step: (optional) Indexing step size.
+```
+
 ### `kd.tuple.make_tuple(*args)` {#kd.tuple.make_tuple}
 Aliases:
 
 - [kd.make_tuple](#kd.make_tuple)
 
 ``` {.no-copy}
-Returns a tuple constructed from the given arguments.
+Returns a tuple-like object containing the given `*args`.
 ```
 
 </section>

docs/cheatsheet.md

@@ -446,7 +446,7 @@ Sub-slicing slices **all** dimensions of a DataSlice or the last dimension when
 only one dimension is specified. The API is called "subslice" because it slices
 a DataSlice to create a sub-DataSlice.
 
-See [kd.subslice](koda_v1_api_reference.md#kd.slices.subslice) APIs for more details.
+See [kd.subslice](api_reference.md#kd.slices.subslice) APIs for more details.
 
 ```py
 ds = kd.slice([[1, 2, 3], [4, 5]])