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

Documenting all possible inputs in the README #59

Closed
francisfuzz opened this issue Oct 24, 2019 · 5 comments
Closed

Documenting all possible inputs in the README #59

francisfuzz opened this issue Oct 24, 2019 · 5 comments
Assignees
Milestone

Comments

@francisfuzz
Copy link

👋 Actions team,

I think it's great that we publish the description for each of the inputs for this action in the action.yml file: https://github.com/actions/checkout/blob/master/action.yml

One opportunity I see here is to publish them in the README. This would be very helpful for any user leveraging this Action and make them aware that such inputs exist, especially those who leverage accompanying features (submodules, LFS, and so forth).

Would the team be open to contributions for updating the README file to include these inputs? In this way, consumers don't need to worry about "digging in the code" and can just get all the information they need up front in the documentation.

Thanks for hearing me out! 🙇

@ericsciple
Copy link
Contributor

thanks @francisfuzz. i'm going to make some changes to the readme shortly... getting close to releasing a v2 version of checkout (behavioral changes). i'll take a stab at this as part of those changes

@francisfuzz
Copy link
Author

Sweet, thanks for that @ericsciple 😎

@ericsciple ericsciple self-assigned this Nov 23, 2019
@ericsciple
Copy link
Contributor

i'm planning to fix this in V2. I wrote a script to update the docs during the build process (so the two dont get out of sync)

@ericsciple ericsciple added this to the v2 milestone Nov 23, 2019
@francisfuzz
Copy link
Author

i'm planning to fix this in V2. I wrote a script to update the docs during the build process (so the two dont get out of sync)

Thanks Eric!

(Where v2 is currently being worked on: #70)

@ericsciple
Copy link
Contributor

fixed in master

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

No branches or pull requests

2 participants