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

Document project.toml #190

Merged
merged 5 commits into from
Aug 25, 2020
Merged

Document project.toml #190

merged 5 commits into from
Aug 25, 2020

Conversation

dfreilich
Copy link
Member

@dfreilich dfreilich commented Aug 18, 2020

Signed-off-by: David Freilich dfreilich@vmware.com
Resolves #165

This PR adds documentation for the project.toml file, referred to as the project descriptor. It was proposed in buildpacks/rfcs#32 and is specified here.

As part of this PR, I am adding project.toml documentation:

  • reference schema
  • adding this to env documentation
  • adding new application developer documentation around project descriptor

Comment on lines +121 to +122
> **NOTE:** `project.toml` can't detect environment variables (so, for instance, if one ran `export FOO=BAR` and added
>`name=FOO` to the `project.toml`, it wouldn't detect any value set for `FOO`).
Copy link
Member Author

Choose a reason for hiding this comment

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

I'm not sure if this is a feature of a bug. Should project.toml detect env vars set? Should I open a bug in pack?

Copy link
Member

Choose a reason for hiding this comment

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

This would be a feature request. I don't believe this is an expectation and given that this is a spec'd it would require an RFC.

Signed-off-by: David Freilich <dfreilich@vmware.com>
Signed-off-by: David Freilich <dfreilich@vmware.com>
Signed-off-by: David Freilich <dfreilich@vmware.com>
@dfreilich dfreilich marked this pull request as ready for review August 19, 2020 01:50
@dfreilich dfreilich requested a review from a team as a code owner August 19, 2020 01:50
Copy link
Member

@jromero jromero left a comment

Choose a reason for hiding this comment

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

LGTM! I left one minor comment. Feel free to ignore.

Comment on lines +121 to +122
> **NOTE:** `project.toml` can't detect environment variables (so, for instance, if one ran `export FOO=BAR` and added
>`name=FOO` to the `project.toml`, it wouldn't detect any value set for `FOO`).
Copy link
Member

Choose a reason for hiding this comment

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

This would be a feature request. I don't believe this is an expectation and given that this is a spec'd it would require an RFC.

content/docs/app-developer-guide/environment-variables.md Outdated Show resolved Hide resolved
@jromero jromero merged commit 15ee1e9 into main Aug 25, 2020
@jromero jromero deleted the 165-project-toml branch August 25, 2020 21:52
github-actions bot pushed a commit that referenced this pull request Aug 25, 2020
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.

Document project.toml
2 participants