Skip to content

docs(liboci-cli): add missing help descriptions to arguments and options#3456

Open
xvchris wants to merge 2 commits intoyouki-dev:mainfrom
xvchris:docs/add-help-descriptions
Open

docs(liboci-cli): add missing help descriptions to arguments and options#3456
xvchris wants to merge 2 commits intoyouki-dev:mainfrom
xvchris:docs/add-help-descriptions

Conversation

@xvchris
Copy link

@xvchris xvchris commented Mar 15, 2026

Description

Several subcommands were missing help text for arguments and options, resulting in blank descriptions in --help output. Fixes #3454.

Add /// doc comments to the fields listed in the issue:

  • kill: <CONTAINER_ID>, <SIGNAL>, --all
  • run: --keep
  • exec: --tty
  • pause, resume, start, state, delete, ps, update: <CONTAINER_ID>

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactoring (no functional changes)

Fixes youki-dev#3454

Several subcommands were missing help text for arguments and options,
resulting in blank descriptions in `--help` output.

Add `///` doc comments to:
- kill: container_id, signal, --all
- run: --keep
- exec: --tty
- pause, resume, start, state, delete, ps, update: container_id

Signed-off-by: xvchris <xvchris@gmail.com>
@YJDoc2 YJDoc2 added the kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt. label Mar 17, 2026
Copy link
Collaborator

@YJDoc2 YJDoc2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I feel

Container Identifier

would be better than

Identifier of the container

No particular reason, but feels better to me. However, current is also acceptable, open for discussion of the wording.

Apart from that lgtm

@xvchris
Copy link
Author

xvchris commented Mar 17, 2026

Good point — updated to 'Container identifier' across all 9 files. Thanks!

Copy link
Collaborator

@YJDoc2 YJDoc2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved, but the last commit was not signed, so dco is missing. Please re sign as per https://github.com/youki-dev/youki/pull/3456/checks?check_run_id=67356689651 , and then we can merge this.

Signed-off-by: xvchris <chrisjh@foxmail.com>
@xvchris xvchris force-pushed the docs/add-help-descriptions branch from fdbb5f6 to 521f4d5 Compare March 19, 2026 14:23
@xvchris
Copy link
Author

xvchris commented Mar 21, 2026

@YJDoc2 The DCO check is now passing ✅ (the second commit already had the correct with email). Since there was a force push after your approval, could you re-approve when you get a chance? Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add missing argument/option descriptions to --help output

2 participants