Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: fix incorrect command-line args in the README #51

Merged

Conversation

ddneilson
Copy link
Contributor

What was the problem/requirement? (What/Why)

The README is showing out-of-date command-line arguments that reflect a previous version of the CLI..

What was the solution? (How)

I've updated the README by comparing its contents against:

  • openjd check --help
  • openjd summary --help
  • openjd run --help
  • openjd schema --help

What is the impact of this change?

Anyone using the README for documentation will not be misled.

How was this change tested?

N/A

Was this change documented?

It is documentation.

Is this a breaking change?

No.


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@ddneilson ddneilson requested a review from a team as a code owner February 15, 2024 01:11
@ddneilson ddneilson force-pushed the ddneilson/fix_readme_args branch from ef753e4 to 5983fee Compare February 21, 2024 15:20
|`--environment`|paths|no| Path to a file containing Environment Template definitions. Can be provided multiple times. |`--environment /path/to/env.template1.json --environment /path/to/env.template2.yaml`|
|`--job-param`, `-p`|string, path|no| The values for the job template's parameters. Can be provided as key-value pairs, inline JSON string, or as path(s) to a JSON or YAML document. If provided more than once then the given values are combined in the order that they appear. |`--job-param MyParam=5`, `-p file://parameter_file.json`, `-p '{"MyParam": "5"}'`|
|`--task-params`, `-tp`|string|no| Instructs the command to run a single task in a Session with the given value for one of the task parameters. The option must be provided once for each task parameter defined for the Step, with each instance providing the value for a different task parameter. Mutually exclusive with `--tasks` and `--maximum-tasks`. |`-tp MyParam=5 -tp MyOtherParam=Foo`|
|`--task-param`, `-tp`|string|no| Instructs the command to run a single task in a Session with the given value for one of the task parameters. The option must be provided once for each task parameter defined for the Step, with each instance providing the value for a different task parameter. Mutually exclusive with `--tasks` and `--maximum-tasks`. |`-tp MyParam=5 -tp MyOtherParam=Foo`|

Choose a reason for hiding this comment

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

I can see --task-params in the Example section, and Description for the --maximum-tasks argument (in the table). I wonder if these should also be updated?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good eye. Oversight on my part!

epmog
epmog previously approved these changes Feb 21, 2024
The README is showing out-of-date command-line arguments that reflect
a previous version of the CLI. This updates the contents of the README.

Signed-off-by: Daniel Neilson <[email protected]>
@ddneilson ddneilson merged commit 45f2e4f into OpenJobDescription:mainline Feb 21, 2024
15 checks passed
@ddneilson ddneilson deleted the ddneilson/fix_readme_args branch February 21, 2024 15:45
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.

3 participants