Quickstart: move the first card on a board
The shortest way from “the plugin is installed” to “a card has moved, and the change is in the work item's history”. Three steps, about five minutes.
Prerequisites
wkdoboards,wkdoworkitems,wkdocore,wkdostorageandwkcoreare installed and enabled.- A project with at least one work item. A board is a view of items; an empty project shows an empty board and says so: No work items in this project yet.
- Your account holds a role in that project which permits editing.
There is nothing to set up. The board keeps no state of its own beside the work items; a column is a field value, not a place.
Step 1: open the board
Open the project's Boards hub:
/doku.php?id=en:projects:acme:boards&do=wkdoboards
Step 2: move a card
Select a card, choose a target column under Move to, and submit.
Dragging works too — it is a layer on top that fills in the same command. The command itself is a visible control and reachable without a pointer. That is deliberate: the accessibility guidance has no drag-and-drop pattern, and an explicit move command is the accepted substitute.
Step 3: change the axis
Switch at the top from State to Type or Assignee. The same items regroup.
Your choice is remembered; the board opens on the same cut next time. That preference is also the only thing the board itself stores.
Check the result
- The message Card moved. appears and the card sits in the new column.
- Open the work item: under History the change stands as a state change with actor and timestamp. Moving the card was an ordinary work-item edit — attributable, audited, visible.
- Counter-check on the state machine: on the State axis, attempt a transition your workflow does not permit. It is refused, by the same machine the editor uses. The offered targets come from the machine, not from the column list — a board that allowed what the editor forbids would be a second, disagreeing definition of the workflow.
- On the Type and Assignee axes that restriction does not exist: those are values, not states, and every target is reachable.
Next step
- wkdoworkitems — the items the board shows.
- wkdoqueries — the same set as a filterable grid instead of columns.
- wkdoboards (German) — the package page: the grouping model.