docs: bring the README in line with the README norm

README.md

@@ -11,72 +11,29 @@ It supports both structured games with managed rounds and a free-play table for
 - **Four ways to play** — Tenceur Hold'em, Five-Draw, Blackjack, and unrestricted free play.
 - **Physical table interaction** — draw, inspect, select, discard, and reveal cards through interactions with the deck and your hand.
 - **Real stakes** — place in-game coins on the felt and play for a shared pot, with payouts tied into DenarEconomy.
+- **Poker tournaments** — host buy-in Hold'em tournaments with chip stacks, rebuys, antes and rising blinds.
 - **Blackjack against the house** — play with an automatic dealer or a player taking the dealer's position, including double and split decisions.
 - **Guild-owned tables** — connect house games to a guild's funds and let its members take over dealing between rounds.
 - **Help at the table** — in-game books explain each game's rules and available actions.
 
-## Poker tournaments
-
-Set `hand-card-limit` under each game in `games.yml` to cap the cards a player
-can hold, including cards still being dealt and Blackjack split groups. The
-bundled limits are 2 for Hold'em and 5 for Five-Draw. Omitted, zero or negative
-limits leave card counts unrestricted; Blackjack and free play omit the limit.
-Existing servers must add the settings to their own `games.yml` to enable them.
-
-At an empty poker table, the host or staff can use
-`/games poker configure <buy-in Denars> <starting chips> <max rebuys> <ante chips> <blind minutes>`.
-A buy-in of `0` selects cash play. A blind interval of `0` keeps blinds fixed;
-otherwise they double at each interval and are collected at the next hand.
-Set the starting blinds through the table options menu.
-
-The player who places the deck is the table host. The host or staff can use
-`/games poker start` or right-click the shoe to deal the next tournament hand,
-even without buying in. The host stays the same as the poker button rotates.
-At cash tables, seated players can also start a hand by clicking the shoe.
-
-Players use `/games poker buyin` before the first hand. On their turn,
-`/games poker bet <chips>` puts extra chips into the pot, followed by a
-`raise` or `check`. `call` collects the chips needed to match automatically.
-`/games bet allin` (or `allin` / `all in` in chat) stakes the entire remaining stack.
-Cash tables take physical stakes only on the current player's turn.
-
-Busted players can `/games poker rebuy` between hands within the configured limit.
-The host can `/games poker kick <player>` between hands and, when only one positive
-stack remains, `/games poker finish` to pay the Denar prize. Leaving or removal
-after tournament play starts forfeits the entry. Before play starts it is refunded.
-Tournament chips never enter player inventories or Denar payouts. Shutdown or
-reload ends tournaments and returns Denar stakes through the table's refund path;
-settings persist, chip stacks do not.
-
 ## Documentation
 
 [Project documentation](https://github.com/TF-Minecraft/Docs/blob/main/projects/Games/README.md)
 
 Technical documentation is maintained in [TF-Minecraft/Docs](https://github.com/TF-Minecraft/Docs).
 
+[Poker tournaments](https://github.com/TF-Minecraft/Docs/blob/main/projects/Games/docs/HOLDEM.md#tournaments)
+
 ## Tests and coverage
 
 After installing the pinned plugin dependencies used by the build workflow, run
-`mvn clean verify` with Java 21. JUnit tests use MockBukkit for Paper registries,
-worlds, players, and inventories, and Mockito for external plugin and packet
-boundaries. Game scenarios exercise public callbacks and assert game rules,
-money conservation, or player-visible effects.
-
-JaCoCo measures all production classes, with no exclusions, and writes HTML, XML,
-and CSV reports to `target/site/jacoco/`. Open `target/site/jacoco/index.html` to
-inspect uncovered behaviour. The build workflow uploads the coverage report
-alongside test results. Coverage data is replaced on each test run; use the full
-suite when assessing repository-wide coverage.
-
-The suite covers game rounds, money conservation, table interactions, and tournament settings. Tests should protect
-supported behaviour, not create impossible internal states merely to execute a
-branch. Where a branch cannot be reached through any real caller, remove it
-rather than force it.
+`mvn clean verify` with Java 21. The suite uses JUnit 5, MockBukkit for Paper
+registries, worlds, players and inventories, and Mockito for external plugin and
+packet boundaries.
 
-The suite includes complete Poker, Draw and Blackjack rounds across the real
-table, deck, and money implementations. Packet tests verify ProtocolLib requests
-through mocked external boundaries; packet encoding and client rendering still
-require a real-server integration run.
+JaCoCo writes HTML, XML and CSV reports to `target/site/jacoco/`, and CI uploads
+them as a `coverage-reports-*` artifact. No coverage threshold is enforced.
+Packet encoding and client rendering still need a run on a real server.
 
 ## License