Skip to content

Conversation

Nishant891
Copy link
Contributor

@Nishant891 Nishant891 commented Jul 29, 2025

Added "Full CLI documentation available at https://docs.k6.io/docs/options" in the output of k6 --help command.

Related to #1154

What?

The current output from k6 --help does not provides a link to the documentation while a man page for k6 --help would be a better option this provides a temporary fix to the issue.

Why?

Checklist

  • I have performed a self-review of my code.
  • I have commented on my code, particularly in hard-to-understand areas.
  • I have added tests for my changes.
  • I have run linter and tests locally (make check) and all pass.

Checklist: Documentation (only for k6 maintainers and if relevant)

Please do not merge this PR until the following items are filled out.

  • I have added the correct milestone and labels to the PR.
  • I have updated the release notes: link
  • I have updated or added an issue to the k6-documentation: grafana/k6-docs#NUMBER if applicable
  • I have updated or added an issue to the TypeScript definitions: grafana/k6-DefinitelyTyped#NUMBER if applicable

Related PR(s)/Issue(s)

@Nishant891 Nishant891 requested a review from a team as a code owner July 29, 2025 10:32
@Nishant891 Nishant891 requested review from inancgumus and joanlopez and removed request for a team July 29, 2025 10:32
@CLAassistant
Copy link

CLAassistant commented Jul 29, 2025

CLA assistant check
All committers have signed the CLA.

@joanlopez
Copy link
Contributor

joanlopez commented Jul 29, 2025

Hi @Nishant891,

Thanks for your contribution! 🙇🏻

I'm not 100% sure if we really want to add this reference to the CLI help output, but even in case that's what we (still) want, you should refer to the corresponding page within https://grafana.com/docs/k6/, as k6.io is deprecated and it will eventually stopped.

I'll let you know what's the team preference once we have a consensus.

@Nishant891
Copy link
Contributor Author

@joanlopez Thank you for the quick feedback! 🙏🏻
I’ll update the reference to point to the relevant page on https://grafana.com/docs/k6/ instead of k6.io.

I'll wait for the team’s decision regarding whether this addition is desired in the CLI help output. Let me know once there’s a consensus! 😊

@inancgumus
Copy link
Contributor

@Nishant891 Thanks for your contribution. Can you apply this suggestion and also fix the linter warning? Thanks.

@Nishant891
Copy link
Contributor Author

Nishant891 commented Aug 1, 2025

@Nishant891 Thanks for your contribution. Can you apply this suggestion and also fix the linter warning? Thanks.

Thank you for the confirmation. I'll apply the suggestion and fix the linter issues.

@Nishant891
Copy link
Contributor Author

Hello @inancgumus I have made the necessary changes and fixed the linter issue.

@joanlopez
Copy link
Contributor

Hey @Nishant891,

Looks like the Lint check is still failing, see this.

Not sure if you have access, but the error looks like:

Error: ../../../internal/cmd/root.go:64:1: File is not properly formatted (gofmt)

Please, can you take a look at it and fix? Thanks! 🙇🏻

@joanlopez joanlopez added the awaiting user waiting for user to respond label Aug 5, 2025
@Nishant891
Copy link
Contributor Author

Hello @joanlopez I believe the linter issue is fixed now.

@joanlopez joanlopez added this to the v1.2.0 milestone Aug 6, 2025
Use: gs.BinaryName,
Short: "a next-generation load generator",
Long: "\n" + getBanner(gs.Flags.NoColor || !gs.Stdout.IsTTY, isTrueColor(gs.Env)) +
"\n\nFull CLI documentation is available at: https://grafana.com/docs/k6",
Copy link
Contributor

Choose a reason for hiding this comment

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

@heitortsergent WDYT about this text?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think the text is ok. Would it be better to link directly to https://grafana.com/docs/k6/latest/using-k6/k6-options/reference/? I wonder if someone who goes to the docs homepage might get confused if they're not seeing anything CLI specific.

Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah sure. I'll edit this line.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I changed the link.

@inancgumus inancgumus removed the request for review from joanlopez August 14, 2025 14:29
@inancgumus inancgumus merged commit d303584 into grafana:master Aug 14, 2025
37 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting user waiting for user to respond

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants