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: update external command documentation #10333

Merged
merged 3 commits into from Jan 19, 2021

Conversation

Rylan12
Copy link
Member

@Rylan12 Rylan12 commented Jan 15, 2021

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same change?
  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your changes? Here's an example.
  • Have you successfully run brew style with your changes locally?
  • Have you successfully run brew typecheck with your changes locally?
  • Have you successfully run brew tests with your changes locally?
  • Have you successfully run brew man locally and committed any changes?

Follow up to #10288

This PR updates the documentation around external commands and how to use the new named_args method.

My ultimate goal is to have completions be automatically generated based on named_args and to have an e.g. brew generate-completions command that will generate completions automatically for a tap. Given this, let me know if it's better for this PR to wait until that's ready (in order to document both at the same time).

@Rylan12 Rylan12 added the documentation Documentation changes label Jan 15, 2021
@BrewTestBot
Copy link
Member

Review period will end on 2021-01-18 at 02:52:18 UTC.

@BrewTestBot BrewTestBot added the waiting for feedback Merging is blocked until sufficient time has passed for review label Jan 15, 2021
Copy link
Member

@MikeMcQuaid MikeMcQuaid left a comment

Choose a reason for hiding this comment

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

Great work again 👏🏻

docs/External-Commands.md Outdated Show resolved Hide resolved
docs/External-Commands.md Outdated Show resolved Hide resolved
docs/External-Commands.md Outdated Show resolved Hide resolved
docs/External-Commands.md Outdated Show resolved Hide resolved
Co-authored-by: Eric Knibbe <enk3@outlook.com>
@Rylan12
Copy link
Member Author

Rylan12 commented Jan 15, 2021

Good suggestions, thanks, @EricFromCanada!

@BrewTestBot
Copy link
Member

Review period ended.

@BrewTestBot BrewTestBot removed the waiting for feedback Merging is blocked until sufficient time has passed for review label Jan 18, 2021
@Rylan12
Copy link
Member Author

Rylan12 commented Jan 18, 2021

Putting this on hold for now until #10342 is merged so that those changes can be reflected here.

@Rylan12
Copy link
Member Author

Rylan12 commented Jan 19, 2021

Okay, now that #10342 has been merged, I've updated this PR to include information about auto-generated usage strings. I'll leave this open for now for any last feedback and I'll plan on merging sometime tomorrow.

@MikeMcQuaid
Copy link
Member

LGTM 👍🏻

@Rylan12 Rylan12 merged commit 8c48547 into Homebrew:master Jan 19, 2021
@Rylan12 Rylan12 deleted the external-command-docs branch January 19, 2021 16:55
@BrewTestBot BrewTestBot added the outdated PR was locked due to age label Feb 19, 2021
@Homebrew Homebrew locked as resolved and limited conversation to collaborators Feb 19, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
documentation Documentation changes outdated PR was locked due to age
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants