Skip to content

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

Merged
YJDoc2 merged 2 commits intoyouki-dev:mainfrom
xvchris:docs/add-help-descriptions
Mar 23, 2026
Merged

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

Conversation

@xvchris
Copy link
Copy Markdown

@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
Copy Markdown
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
Copy Markdown
Author

xvchris commented Mar 17, 2026

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

Copy link
Copy Markdown
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
Copy Markdown
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!

@YJDoc2 YJDoc2 enabled auto-merge (squash) March 23, 2026 12:16
@YJDoc2 YJDoc2 merged commit 916991e into youki-dev:main Mar 23, 2026
28 checks passed
@github-actions github-actions bot mentioned this pull request Mar 23, 2026
@YJDoc2
Copy link
Copy Markdown
Collaborator

YJDoc2 commented Mar 23, 2026

Thanks for your contribution @xvchris :)

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