diff --git a/docs/game/actions.md b/docs/game/actions.md
index 9dda955..c3261e1 100644
--- a/docs/game/actions.md
+++ b/docs/game/actions.md
@@ -37,7 +37,7 @@ Think of actions like function calls. An action for a chess move would be like a
function named `move` that takes two arguments `piece` and `space`. This is a
single action, not two. The player's client would essentially make a call like:
-
+
For this reason, you will sometimes see the values selected by the players
called "arguments".
diff --git a/docs/game/board.md b/docs/game/board.md
index 9a3290d..df5fced 100644
--- a/docs/game/board.md
+++ b/docs/game/board.md
@@ -39,8 +39,16 @@ graph TD;
`"];
```
-Spaces can contain other spaces and pieces. Pieces can even contain other
-pieces, e.g. as when placing tokens onto a card.
+In the context of an actual game board, the Spaces and Pieces in this diagram
+might look something like this:
+
+
+
+Here the Spaces are grey and the Pieces are blue. Spaces can contain other
+spaces and pieces. For example the Tableau here contains the Hand and the Hand
+contains the Cards. Pieces can also contain other pieces, e.g. as when placing
+tokens onto a card.
## Subclassing
@@ -155,6 +163,8 @@ elements can be queried using the `owner` property.
Rememeber the difference between `player` and `owner`. They are related but distinct.
- `player` is a property you set that assigns a game element to that player, and is usually permanent. Think of it like a name tag, or the color of the element.
- `owner` is a read-only property that indicates where the piece currently resides. A Card might be owned by a player while they hold it, but the card "doesn't have their name on it" so to speak, and may change hands.
+
+
:::
The Player object also conveniently has methods for retrieving these elements:
diff --git a/docs/game/players.md b/docs/game/players.md
index 8dbf5c4..b6cf096 100644
--- a/docs/game/players.md
+++ b/docs/game/players.md
@@ -84,7 +84,7 @@ or many owned elements.
## Profile badge
It is generally good practice to place the
-[](../api/modules#profilebadge) component into the UI to mark the
+[<ProfileBadge/>](../api/modules#profilebadge) component into the UI to mark the
player's area of the board and show information about the player, such as
score. This automatically displays if it's the player's turn, whether they're
online, and links to their profile, if any. It can be further customized with
diff --git a/docs/ui/layout.md b/docs/ui/layout.md
index 7cb7f1d..3104bce 100644
--- a/docs/ui/layout.md
+++ b/docs/ui/layout.md
@@ -3,11 +3,12 @@ sidebar_position: 3
---
# Layout
-A layout is basically just a strategy for how items are visually placed inside
-other items. A layout might say that items should be laid out in a row, or a
-stack, or a grid. When many items enter the same space, it might say that they
-should scale down to fit, should squish together, or that only a certain number
-should actually be visible.
+Customizing the game UI probably requires declaring several layouts. Each layout
+provides a strategy for a given game element about how items should be visually
+placed inside it. A layout might declare that for a given area, items should be
+laid out in a row, or a stack, or a grid. When many items enter the same space,
+it might declare whether they should scale down to fit, should squish together,
+or whether only a certain number of them should actually be visible.
All layout declarations go in the `layout` of the main
[`render`](../api/modules#render) function, e.g.:
@@ -16,9 +17,7 @@ All layout declarations go in the `layout` of the main
render(setup, {
...
layout: (board) => {
- board.layout('mat', {
- area: { top: 5, height: 90, left: 5, width: 90 },
- });
+ // layout declarations go here
...
}
diff --git a/src/components/Layout.jsx b/src/components/Layout.jsx
index 8d11175..3d442aa 100644
--- a/src/components/Layout.jsx
+++ b/src/components/Layout.jsx
@@ -142,7 +142,7 @@ const Layout = () => {
gap
gap size is absolute to board size
diff --git a/static/img/board.png b/static/img/board.png
new file mode 100644
index 0000000..7945e58
Binary files /dev/null and b/static/img/board.png differ
diff --git a/static/img/owner.png b/static/img/owner.png
new file mode 100644
index 0000000..f742f74
Binary files /dev/null and b/static/img/owner.png differ