Skip to content

Conversation

@sashalevin
Copy link

This PR adds detailed help text with usage examples to all kci-dev commands.

What changed:

  • Added comprehensive help text explaining each command's purpose
  • Included practical usage examples for all commands
  • Commands now show help instead of errors when run without parameters (where applicable)

Commands updated: bisect, checkout, commit, config, patch, results, testretry, watch

Sasha Levin added 9 commits June 9, 2025 20:15
…mprove command documentation

- Display help instead of error when command is run without options
- Add comprehensive help text with usage examples
- Improve option descriptions with clearer explanations
- Specify that --filter and --field options can be used multiple times

Signed-off-by: Sasha Levin <sashal@kernel.org>
…mmand documentation

- Display help instead of error when command is run without options
- Add comprehensive help text with usage examples
- Improve option descriptions with clearer explanations and examples
- Document that bisection state is saved and can be resumed
- Specify that filter options can be used multiple times

Signed-off-by: Sasha Levin <sashal@kernel.org>
…command documentation

- Display help instead of error when command is run without options
- Add comprehensive help text with usage examples
- Improve option descriptions with clearer explanations
- Document requirement for either --commit or --tipoftree
- Specify that filter options can be used multiple times

Signed-off-by: Sasha Levin <sashal@kernel.org>
…mmand documentation

- Display help when run without options outside a git repository
- Add comprehensive help text with usage examples
- Improve option descriptions with clearer explanations
- Document that command is experimental
- Add note about API integration status

Signed-off-by: Sasha Levin <sashal@kernel.org>
- Add comprehensive help text explaining the command purpose
- Include usage examples for different scenarios
- Clarify default behavior and file locations
- Improve option description with better formatting

Signed-off-by: Sasha Levin <sashal@kernel.org>
- Add comprehensive help text explaining patch testing functionality
- Include usage examples for different scenarios
- Clarify support for both patch and mbox files
- Improve option descriptions with defaults and better formatting

Signed-off-by: Sasha Levin <sashal@kernel.org>
…roup documentation

- Display help instead of error when command group is run without subcommand
- Add comprehensive help text with list of available subcommands
- Include usage examples for common scenarios
- Make group invoke without command to enable help display

Signed-off-by: Sasha Levin <sashal@kernel.org>
- Add comprehensive help text explaining test retry functionality
- Include usage examples showing how to get node IDs
- Clarify when and why to use test retries
- Improve option description with better context

Signed-off-by: Sasha Levin <sashal@kernel.org>
- Add comprehensive help text explaining real-time job monitoring
- Include usage examples for different watching scenarios
- Clarify when to use watch command
- Improve option descriptions with examples
- Specify that job-filter can be used multiple times

Signed-off-by: Sasha Levin <sashal@kernel.org>
@padovan padovan requested a review from JenySadadia June 10, 2025 01:32
@aliceinwire
Copy link
Member

Thanks for improving kci-dev documentation!
looks much more clear

@aliceinwire aliceinwire merged commit 0b8c12a into kernelci:main Jun 11, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants