Skip to content

Add terminology section to the buildpack spec#300

Merged
sambhav merged 7 commits intobuildpack/0.9from
buildpack-terminology
Aug 23, 2022
Merged

Add terminology section to the buildpack spec#300
sambhav merged 7 commits intobuildpack/0.9from
buildpack-terminology

Conversation

@natalieparellano
Copy link
Copy Markdown
Member

Resolves #145

Signed-off-by: Natalie Arellano <narellano@vmware.com>
Signed-off-by: Natalie Arellano <narellano@vmware.com>
@ekcasey ekcasey linked an issue Mar 30, 2022 that may be closed by this pull request
@ekcasey
Copy link
Copy Markdown
Member

ekcasey commented Mar 30, 2022

Moving to buildpack/0.9 - a branch needs to be created

Signed-off-by: Natalie Arellano <narellano@vmware.com>

## Terminology

### CNB Terminology
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Feedback from 4/21 Working Group: (if possible, without making each term its own section) we should link back to this section as much as is practical.

@natalieparellano natalieparellano self-assigned this Jun 16, 2022
@natalieparellano natalieparellano changed the base branch from buildpack/0.8 to buildpack/0.9 June 16, 2022 18:22
Signed-off-by: Natalie Arellano <narellano@vmware.com>
Natalie Arellano added 2 commits June 16, 2022 14:43
#### Buildpack Implementations
#### Stacks

A buildpack descriptor that specifies `stacks` MUST describe a buildpack that implements the [Buildpack Interface](#buildpack-interface).
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I don't really know what the latter half of this sentence is for


#### Order Buildpacks

A buildpack descriptor that specifies `order` MUST be [resolvable](#order-resolution) into an ordering of buildpacks that implement the [Buildpack Interface](#buildpack-interface).
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Moved to terminology

Signed-off-by: Natalie Arellano <narellano@vmware.com>
Where:
- O and P are buildpack orders.
- A through H are buildpack implementations.
- A through H are component buildpacks.
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I think this is correct. But I'm a bit less sure of myself here.

@natalieparellano
Copy link
Copy Markdown
Member Author

@buildpacks/buildpack-authors-tooling-maintainers @buildpacks/implementation-maintainers I think this is ready for another review

Copy link
Copy Markdown
Member

@sambhav sambhav 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 still feel a bit queasy about "component" buildpack as a term but I can't think of a good alternative.

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.

Add terminology section to Buildpack API

6 participants