Refocus command guidance on players

docs/eagle0pedia/src/content/docs/commands/index.md

@@ -3,13 +3,13 @@ title: Eagle Commands
 description: Strategic command reference for Eagle command panels.
 ---
 
-Eagle commands are the strategic actions a faction can take from a province command panel. The server advertises available commands with `AvailableCommand`, and the client posts the matching `SelectedCommand`.
+Eagle commands are the strategic actions a faction can take from a province command panel. The panel shows the actions that are possible for the current province and situation.
 
 Most commands belong to the province currently acting this turn. Some are reaction commands, such as resolving diplomacy offers, handling captured heroes, or choosing a battle aftermath decision.
 
-## How command availability works
+## Why commands appear and disappear
 
-The command panel is contextual. Eagle sends the client the commands that are valid for the current province, hero, phase, resources, and world state. A command that does not apply is normally absent rather than shown as a permanently disabled option.
+The command panel changes as the game changes. If an action is not currently possible, it is usually absent instead of appearing as a disabled button.
 
 Availability can change when:
 
@@ -17,27 +17,29 @@ Availability can change when:
 - a hero, battalion, prisoner, event, or incoming army moves or changes state;
 - the game advances to another phase;
 - a profession or minimum stat is required; or
-- a target is no longer valid because another simultaneous action resolved.
+- a target is no longer valid.
 
-An **eligible hero** is a hero currently allowed to perform that command. Eligibility can include location, faction membership, vigor, profession, leadership status, and command-specific restrictions. The entry for each command lists the important requirements.
+If a command you expected is missing, check its **Available when** entry. The most common reasons are insufficient gold, food, or vigor; no valid target; the wrong hero profession; the hero being elsewhere; or the province having already spent its turn.
+
+An **eligible hero** is simply one of the heroes you can currently choose to perform that action. Eligibility can depend on location, vigor, profession, leadership, and the command's own restrictions.
 
 ## Reading a command entry
 
 - **Hero requirements** identifies profession or hero restrictions. “None” means no particular profession, not that the command never needs an acting hero.
 - **Vigor cost** is paid by the selected acting hero when the command resolves as described.
 - **Available when** summarizes the state that makes the command appear.
-- **Effect** describes the state change after a valid selection.
-- **Selection** lists the choices the player must submit.
-
-The server validates the submitted selection against the advertised command. If the underlying state changes before resolution, the game may reject or invalidate a choice rather than applying an action that is no longer legal.
+- **Effect** describes what the action does.
+- **Selection** lists what you must choose before confirming it.
 
 ## Turns, reactions, and command states
 
-Most commands under **Normal Command Phase Commands** spend the acting province's turn. Entries explicitly say when an action does not take the turn. Conditional decisions—such as diplomacy responses, attack and defense decisions, riots, and battle aftermath—belong to their own phases and do not grant another normal province action.
+Most commands under **Normal Command Phase Commands** spend the acting province's turn. After using one, you normally cannot choose another ordinary action for that province this round. Entries explicitly identify exceptions such as Issue Orders.
+
+Diplomacy responses, attack and defense decisions, riots, and battle aftermath are prompted by events in their own phases. Resolving one of these decisions does not replace or grant another ordinary province turn.
 
 **Travel** enters a temporary command state. Traveling commands then become available, and the player may use multiple traveling commands in the same round. **Return** leaves that state and returns to the normal province command flow. Individual traveling actions can still spend resources or alter which later choices remain available.
 
-Treat a submitted command as an order, not a preview. Do not rely on being able to undo it after submission; check the selected hero, destination, units, and supplies before confirming.
+Before confirming any command, check the selected hero, destination, units, gold, and food. Treat confirmation as issuing the order rather than previewing it.
 
 <span class="command-reference-marker" aria-hidden="true"></span>