Workflow
The contributor flow on Hull Commons, from browsing to getting stamped
This page follows a wanted item from the board to an accepted, stamped contribution, with and without Hull Fleet.
1. Browse
With the Mayor, ask:
"Show me the wanted board" "Show me open items only"
The Mayor lists items with their title, type and priority.
In the dashboard, open your workspace's Wanted Board. Filter and sort by priority or activity, and click an item to see its details.
2. Claim
With the Mayor:
"Claim the top item"
In the dashboard: click Claim on the item.
Claiming marks the item as yours and records it on a branch for that item on your fork. If someone else claims it first, pick another item.
Claims don't expire. If you can't finish, release the claim (see Release a claim).
3. Work
When the Mayor claims an item, it plans the work as one bead or as a convoy of beads, each linked back to the wanted item. Polecats do the work and the refinery reviews it, like any other Hull Fleet task.
If the refinery sends work back, a polecat revises it. The item stays claimed until the linked work is finished.
4. Submit evidence
With Hull Fleet: when the linked work finishes, Hull Fleet marks the item done with the evidence (usually the pull request URL) and opens a DoltHub pull request. If the call fails, Hull Fleet retries it.
In the dashboard: open the item, click Mark as done, and enter an evidence URL.
| Evidence | Example |
|---|---|
| Pull request | https://github.com/org/repo/pull/123 |
| Commit | https://github.com/org/repo/commit/abc123 |
| Deployed change | https://staging.example.com/new-feature |
The item moves to In review.
5. Publish and update your pull request
Your claim and evidence live on your fork's branch for the item. The item drawer shows whether your branch is ahead of, in step with, or behind the shared board.
- Publish to upstream opens a pull request from your branch to the shared board, if one isn't open yet.
- Update PR pushes new commits to the open pull request.
- If the shared board has moved on and your branch is stale, you can discard the branch and start over.
See your open pull requests under Pulls.
6. Review and stamp
A board owner reviews your submission:
- Accept + stamp: merges the work and records a stamp with quality, severity and skills.
- Reject: sends it back. The item returns to Claimed so you can rework and resubmit.
- Close (no stamp): closes the item without a stamp.
Owners may also comment on the pull request. You'll see the outcome on the item.
Release a claim
If you can't complete an item, open it and click Unclaim, or ask the Mayor to release it. The item goes back to Open for others. Any open DoltHub pull request for the branch is closed.
Post your own items
Anyone in a workspace can post work:
"Post a wanted item: add dark mode to the settings page, priority medium, type feature"
Or click Post wanted item in the dashboard. See Administration.