Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

README utilization example uses --processes, but the command defines --workers

Open Beginner friendly
#51 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
90/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
django, python
Domain
cli, documentation

Research direction

Open the README's Utilization section and compare its worker command example with WorkerCommand.add_arguments(), which defines the available flags. Update the example so it uses the intended option, then verify that the documented command no longer produces an unrecognised-argument error.

Written by the indexing model from the issue text.

Description

Noted while adding the Queues section to the README (fair multi-queue scheduling, codingjoe-fair-multi-queue-scheduling).

The README's Utilization section advertises:

uv run manage.py threadmill worker --processes 4 --threads 2

but WorkerCommand.add_arguments() defines -w/--workers, not --processes. The example fails with an unrecognised-argument error.

Fix is to rename the flag in the README example (or add an alias, if --processes is the intended name).

Dominant language
Python
Stars
12
Forks
1
Avg merge
19h 11m
Merged PRs (30d)
12

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from codingjoe/threadmill

All issues in codingjoe/threadmill

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.