The [block] command STILL does not actually exist
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- cli
- Domain
- cli, documentation
Research direction
Start with the source for the command index and the block documentation page linked in the report, checking how available commands are selected for the live WP-CLI version. Done means the live documentation no longer presents block as an available command, or clearly marks it as alpha/beta, and the commands index agrees.
Written by the indexing model from the issue text.
Description
Bug Report
- Yes, I reviewed the contribution guidelines.
- Yes, more specifically, I reviewed the guidelines on how to write clear bug reports.
Describe the current, buggy behavior
The block command still enumerated in the online docs despite not being available in the live build of the CLI. I reported this on the 28th of April (see #1002) and was told at the time that the new release was, "around the corner". It has been 4.5 months. The documentation that incorrectly asserts that the block command is available has been live since mid December of 2025 (roughly nine months ago).
Describe how other contributors can replicate this bug
- Go to https://developer.wordpress.org/cli/commands/block/
- Observe that the page you went to is live
- https://developer.wordpress.org/cli/commands/
- Observe that it provides a link to that page in the third row of the table enumerating available commands
Describe what you would expect as the correct outcome
I expect the documentation to enumerate the available commands in the currently-live version of the CLI.
Let us know what environment you are running this on
OS: Linux 4.14.318-241.531.amzn2.x86_64 #1 SMP Tue Jun 27 21:49:00 UTC 2023 x86_64
Shell: /bin/bash
PHP binary: /usr/local/bin/php
PHP version: 8.5.6
php.ini used: /usr/local/etc/php/php.ini
MySQL binary: /usr/bin/mariadb
MySQL version: mariadb from 11.8.6-MariaDB, client 15.2 for debian-linux-gnu (x86_64) using EditLine wrapper
SQL modes:
WP-CLI root dir: phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir: phar://wp-cli.phar/vendor
WP_CLI phar path: phar:///usr/local/bin/wp
WP-CLI packages dir:
WP-CLI cache dir: /home/joshualip/.wp-cli/cache
WP-CLI global config:
WP-CLI project config:
WP-CLI version: 2.12.0
Provide a possible solution
I would recommend that the documentation be updated to not list alpha/beta commands or, if that is not an option, to at least mark the listed alpha/beta commands as available only in the alpha/beta.
- Dominant language
- Gherkin
- Stars
- 90
- Forks
- 34
- Avg merge
- 3h 19m
- Merged PRs (30d)
- 18
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from wp-cli/wp-cli-bundle
-
scope:distribution
Difficulty 3/5 1-2 days Newbie friendliness 38/100
wp-cli/wp-cli-bundle#593 ·
-
scope:distribution
Difficulty 4/5 3-5 days Newbie friendliness 35/100
wp-cli/wp-cli-bundle#134 · 7 comments · 1 reaction ·
All issues in wp-cli/wp-cli-bundle
Similar issues
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
anthropics/skills#1811 · 1 comment ·
-
category/development priority/P2 scope/file-operations scope/testing type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
CachyOS/distribution#587 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
datalayer/mcp-compose#42 ·