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

[Docs] Adds clarification in user-guide documentation #4256

Merged
merged 5 commits into from Jan 27, 2021

Conversation

yinonov
Copy link
Contributor

@yinonov yinonov commented Jan 26, 2021

it is not clear or documented anywhere that a local file path is an option as argument to the path parameter.
cli help scheme, as well, implies the last argument to be a url (hint [options] https://url.com).
as only starting to use webhint cli I had this only clarified in a response in the gitter channel

Pull request checklist

Make sure you:

For non-trivial changes, please make sure you also:

  • Added/Updated related documentation.
  • Added/Updated related tests.

Short description of the change(s)

it is not clear or documented anywhere that a local file path is an option as argument to the path parameter.
cli _help_ scheme, as well, implies the last argument to be a url (`hint [options] https://url.com`).
as only starting to use webhint cli I had this only clarified in a response in the gitter channel
@yinonov yinonov changed the title [Docs] Adds clarification to param in user-guide documentation [Docs] Adds clarification in user-guide documentation Jan 26, 2021
Copy link
Member

@antross antross left a comment

Choose a reason for hiding this comment

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

Thanks for putting this together @yinonov!

@@ -26,7 +26,7 @@ best practices that may be applied to your site, complete the following steps.
uses `npx` to run the `npm` package without installing it.

```bash
npx hint https://example.com
npx hint https://example.com // or relative path e.g. './path/to/my.html'
Copy link
Member

Choose a reason for hiding this comment

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

What do you think about breaking these apart as two complete commands? I think that might help for those that want to copy-paste a local file example with minimal required changes. E.g.


npx hint https://example.com

or

npx hint ./path/to/my.html

Copy link
Contributor Author

Choose a reason for hiding this comment

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

sure, it's nicer this way

Copy link
Member

@antross antross left a comment

Choose a reason for hiding this comment

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

LGTM. Thanks for helping improve the documentation!

I'll merge this after CI finishes, then the doc changes will go live with our next release.

Removes trailing spaces the linter was complaining about.
@antross antross merged commit 792eb8f into webhintio:main Jan 27, 2021
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.

None yet

2 participants