Skip to content

Improved experience with MLCube help in console environments.#321

Merged
sergey-serebryakov merged 1 commit into
mlcommons:masterfrom
sergey-serebryakov:misc/improved-help-for-console
Jul 25, 2023
Merged

Improved experience with MLCube help in console environments.#321
sergey-serebryakov merged 1 commit into
mlcommons:masterfrom
sergey-serebryakov:misc/improved-help-for-console

Conversation

@sergey-serebryakov

Copy link
Copy Markdown
Contributor
  • Updating documentation for config command.
  • Various improvements in command line-based help pages:
    • Fixing bugs related in markdown-to-text conversion.
    • Keeping code blocks as is in textual format (wrapped with ``, e.g., pip install cookiecutter).
    • Introducing new and renaming existing sections in console-based help messages: "Brief description", "Long description", "Options" and "Examples".
    • The doc strings can now contain on very long description block. This will not be part of console-based help, but will be part of web-based documentation pages.
    • Simplifying logic that's used to print epilogues (example usages).

- Updating documentation for config command.
- Various improvements in command line-based help pages:
  - Fixing bugs related in markdown-to-text conversion.
  - Keeping code blocks as is in textual format (wrapped with ``, e.g., `pip install cookiecutter`).
  - Introducing new and renaming existing sections in console-based help messages: "Brief description", "Long description", "Options" and "Examples".
  - The doc strings can now contain on <long>very long description</long> block. This will not be part of console-based help, but will be part of web-based documentation pages.
  - Simplifying logic that's used to print epilogues (example usages).
@sergey-serebryakov
sergey-serebryakov requested a review from a team as a code owner July 25, 2023 00:53
@github-actions

Copy link
Copy Markdown
Contributor

MLCommons CLA bot All contributors have signed the MLCommons CLA ✍️ ✅

@sergey-serebryakov
sergey-serebryakov merged commit 06ab6f3 into mlcommons:master Jul 25, 2023
@sergey-serebryakov
sergey-serebryakov deleted the misc/improved-help-for-console branch July 25, 2023 00:55
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 25, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant