diff --git a/crates/typst/src/foundations/array.rs b/crates/typst/src/foundations/array.rs
index 8f5703bbb..4c05e3751 100644
--- a/crates/typst/src/foundations/array.rs
+++ b/crates/typst/src/foundations/array.rs
@@ -223,8 +223,11 @@ impl Array {
         self.0.pop().ok_or_else(array_is_empty)
     }
 
-    /// Inserts a value into the array at the specified index. Fails with an
-    /// error if the index is out of bounds.
+    /// Inserts a value into the array at the specified index, shifting all
+    /// subsequent elements to the right. Fails with an error if the index is
+    /// out of bounds.
+    ///
+    /// To replace an element of an array, use [`at`]($array.at).
     #[func]
     pub fn insert(
         &mut self,
diff --git a/crates/typst/src/layout/grid/mod.rs b/crates/typst/src/layout/grid/mod.rs
index 30507e7bc..bdc1ff442 100644
--- a/crates/typst/src/layout/grid/mod.rs
+++ b/crates/typst/src/layout/grid/mod.rs
@@ -701,22 +701,22 @@ pub struct GridVLine {
 ///
 /// #grid(
 ///   fill: (x, y) => rgb(
-///     if calc.odd(x + y) { "EFF0F3" }
-///     else { "7F8396" }
+///     if calc.odd(x + y) { "7F8396" }
+///     else { "EFF0F3" }
 ///   ),
 ///   columns: (1em,) * 8,
 ///   rows: 1em,
 ///   align: center + horizon,
 ///
-///   [♜], [♞], [♝], [♛], [♚], [♝], [♞], [♜],
-///   [♟], [♟], [♟], [♟], [],  [♟], [♟], [♟],
+///   [♖], [♘], [♗], [♕], [♔], [♗], [♘], [♖],
+///   [♙], [♙], [♙], [♙], [],  [♙], [♙], [♙],
 ///   grid.cell(
 ///     x: 4, y: 3,
 ///     stroke: blue.transparentize(60%)
-///   )[♟],
+///   )[♙],
 ///
-///   ..(grid.cell(y: 6)[♙],) * 8,
-///   ..([♖], [♘], [♗], [♕], [♔], [♗], [♘], [♖])
+///   ..(grid.cell(y: 6)[♟],) * 8,
+///   ..([♜], [♞], [♝], [♛], [♚], [♝], [♞], [♜])
 ///     .map(grid.cell.with(y: 7)),
 /// )
 /// ```