diff --git a/buildpack.md b/buildpack.md index fb383ef7..4781ca9d 100644 --- a/buildpack.md +++ b/buildpack.md @@ -937,6 +937,8 @@ For a given layer, the buildpack MAY specify: ### buildpack.toml (TOML) ```toml +api = "" + [buildpack] id = "" name = "" @@ -967,6 +969,13 @@ The buildpack ID: If an `order` is specified, then `stacks` MUST NOT be specified. +The buildpack API: + - MUST be in form `.` or ``, where `` is equivalent to `.0` + - MUST describe the implemented buildpack API. + - SHALL indicate compatibility with a given lifecycle according to the following rules: + - When `` is `0`, the buildpack is only compatible with lifecycles implementing that exact buildpack API. + - When `` is greater than `0`, the buildpack is only compatible with lifecycles implementing buildpack API `.`, where `` of the lifecycle equals `` of the buildpack and `` of the lifecycle is greater than or equal to `` of the buildpack. + #### Buildpack Implementations A buildpack descriptor that specifies `stacks` MUST describe a buildpack that implements the [Buildpack Interface](#buildpack-interface).