From 9d8e4c53dc2ef574a2fcc978f1f4d45ab2b26e6d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20Gir=C3=A3o=20Serr=C3=A3o?=
 <5621605+rodrigogiraoserrao@users.noreply.github.com>
Date: Thu, 22 Dec 2022 18:01:03 +0000
Subject: [PATCH] Update reference for offset.

---
 docs/styles/offset.md | 43 ++++++++++++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 13 deletions(-)

diff --git a/docs/styles/offset.md b/docs/styles/offset.md
index 059a1edbe..e8cf643d6 100644
--- a/docs/styles/offset.md
+++ b/docs/styles/offset.md
@@ -1,19 +1,33 @@
 # Offset
 
-The `offset` rule adds an offset to the widget's position. The offset is given as two values.
-
-Coordinates may be specified individually with `offset-x` and `offset-y`.
+The `offset` rule defines an offset for the position of the widget.
 
 ## Syntax
 
-```
-offset: <SCALAR> <SCALAR>;
-```
+--8<-- "docs/snippets/syntax_block_start.md"
+offset: <a href="../css_types/scalar.md">&lt;scalar&gt;</a> <a href="../css_types/scalar.md">&lt;scalar&gt;</a>;
+
+offset-x: <a href="../css_types/scalar.md">&lt;scalar&gt;</a>;
+offset-y: <a href="../css_types/scalar.md">&lt;scalar&gt;</a> 
+--8<-- "docs/snippets/syntax_block_end.md"
+
+The two [`<scalar>`](../css_types/scalar.md) in the `offset` define, respectively, the offsets in the horizontal and vertical axes for the widget.
+
+To specify an offset along a single axis, you can use `offset-x` and `offset-y`.
+
+### Values
+
+--8<-- "docs/snippets/type_syntax/scalar.md"
 
 ## Example
 
 In this example, we have 3 widgets with differing offsets.
 
+=== "Output"
+
+    ```{.textual path="docs/examples/styles/offset.py"}
+    ```
+
 === "offset.py"
 
     ```python
@@ -26,20 +40,23 @@ In this example, we have 3 widgets with differing offsets.
     --8<-- "docs/examples/styles/offset.css"
     ```
 
-=== "Output"
-
-    ```{.textual path="docs/examples/styles/offset.py"}
-    ```
-
 ## CSS
 
 ```sass
-/* Move the widget 2 cells in the x direction, and 4 in the y direction. */
-offset: 2 4;
+/* Move the widget 8 cells in the x direction and 2 in tye y direction */
+offset: 8 2;
+
+/* Move the widget 4 cells in the x direction
+offset-x: 4;
+/* Move the widget -2 cells in the y direction
+offset-y: -2;
 ```
 
 ## Python
 
+You cannot change programmatically the offset for a single axis.
+You have to set the two axes at the same time.
+
 ```python
 # Move the widget 2 cells in the x direction, and 4 in the y direction.
 widget.styles.offset = (2, 4)