The docs never list the taskuary command's options, and the "port is taken" advice is incomplete.
Where
docs/site/*.md never mention --port, --host, --no-browser or --debug (only --done appears)docs/site/troubleshooting.md, "The port is taken", says only to set TASKUARY_PORT. It does not mention --port, or that the CLI already moves to a free port by itself (see taskuary/cli.py)
Done when
docs/site/start-here.md has a ## Command-line options section with the everyday flags (--port, --host, --no-browser, --debug), worded from taskuary --help- the troubleshooting entry mentions
--port and the automatic free port
Test - cd website && npm run build:docs && npm test (website/test/docs.test.mjs checks headings and anchors). Commit the regenerated site/docs/ too.
Getting started: pip install -e ".[dev]", then python -m pytest -q (offline, a few seconds). UI work: cd website && npm ci && npm test. See CONTRIBUTING.md. One small PR with the change and its test is perfect.
The docs never list the
taskuarycommand's options, and the "port is taken" advice is incomplete.Where
docs/site/*.mdnever mention--port,--host,--no-browseror--debug(only--doneappears)docs/site/troubleshooting.md, "The port is taken", says only to setTASKUARY_PORT. It does not mention--port, or that the CLI already moves to a free port by itself (seetaskuary/cli.py)Done when
docs/site/start-here.mdhas a## Command-line optionssection with the everyday flags (--port,--host,--no-browser,--debug), worded fromtaskuary --help--portand the automatic free portTest -
cd website && npm run build:docs && npm test(website/test/docs.test.mjschecks headings and anchors). Commit the regeneratedsite/docs/too.Getting started:
pip install -e ".[dev]", thenpython -m pytest -q(offline, a few seconds). UI work:cd website && npm ci && npm test. See CONTRIBUTING.md. One small PR with the change and its test is perfect.