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

Clarify dockerfile and path inputs #16

Merged
merged 1 commit into from
Mar 23, 2020
Merged

Clarify dockerfile and path inputs #16

merged 1 commit into from
Mar 23, 2020

Conversation

zappy-shu
Copy link
Contributor

Clarify the documentation for the dockerfile and path action inputs including how they relate to each other.

Fixes #11

Clarify the documentation for the dockerfile and path action inputs
including how they relate to each other.

Signed-off-by: Nick Adcock <nick.adcock@docker.com>
Name of the Dockerfile. Defaults to `{path}/Dockerfile`.
Path to the Dockerfile. Defaults to `{path}/Dockerfile`

Note when set this path is **not** relative to the `path` input but is instead relative to the current working directory.
Copy link
Member

Choose a reason for hiding this comment

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

This is really confusing. If the path is . then it is relative to the path. What do you mean exactly?

Copy link
Member

Choose a reason for hiding this comment

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

Do you mean "if you change it from the default it is relative to the current working directory not the path"?

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 pretty much.

path: path/to/wherever
dockerfile: my/Dockerfile

Is equivalent to docker --file my/Dockerfile path/to/wherever which would mean your directory structure looked something like:

.
- my/
  - Dockerfile
- path/
  - to/
     - wherever/

"Path to the Dockerfile. Defaults to {path}/Dockerfile" Is pretty much a copy/paste of the docker help build output:

  -f, --file string             Name of the Dockerfile (Default is
                                'PATH/Dockerfile')

Happy to change to something more clear if you have better wording

Copy link
Member

Choose a reason for hiding this comment

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

I think its ok for now, I think however you explain it it might be confusing...

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.

docs: Change use of "Name" to "Path" in dockerfile option information
2 participants