Merge pull request cds-hooks#584 from buildpacks/project-descriptor-v2

Update docs to project descriptor v2

Author: AidanDelaney

content/docs/app-developer-guide/using-project-descriptor.md

@@ -19,20 +19,20 @@ Note the `include` and `exclude` sections in the below `project.toml` file use `
 file at the root of the application. For more on `gitignore` matching see [these docs](https://linuxize.com/post/gitignore-ignoring-files-in-git/#literal-file-names).
 
 ```toml
-[project]
+[_]
 id = "io.buildpacks.bash-script"
 name = "Bash Script"
 version = "1.0.0"
 
-[build]
+[io.buildpacks]
 exclude = [
     "/README.md",
     "bash-script-buildpack"
 ]
 
 include = []
 
-[[build.buildpacks]]
+[[io.buildpacks.group]]
 uri = "bash-script-buildpack/"
 ```
 
@@ -67,24 +67,24 @@ understand the environment), we would want to add it to our `project.toml`.
 Below is an expanded `project.toml`, with an additional buildpack and environment variable included.
 
 ```toml
-[project]
+[_]
 id = "io.buildpacks.bash-script"
 name = "Bash Script"
 version = "1.0.0"
 
-[build]
+[io.buildpacks]
 exclude = [
     "README.md",
     "bash-script-buildpack"
 ]
-[[build.buildpacks]]
+[[io.buildpacks.group]]
 uri = "../../buildpacks/hello-world/"
 
 
-[[build.buildpacks]]
+[[io.buildpacks.group]]
 uri = "bash-script-buildpack/"
 
-[[build.env]]
+[[io.buildpacks.build.env]]
 name='HELLO'
 value='WORLD'
 ```

content/docs/reference/config/project-descriptor.md

@@ -12,7 +12,7 @@ $ pack build --descriptor <project-descriptor path>
 
 The schema for the `project descriptor` is:
 
-- #### `project` _(table, optional)_
+- #### `_` _(table, optional)_
   A configuration table for a project.
 
   - **`id`** _(string, optional)_\
@@ -42,10 +42,10 @@ The schema for the `project descriptor` is:
       - **`uri`** _(string, optional)_\
         If the project uses a nonstandard license, you may use `uri` to point to the license.
 
-- #### `build` _(table, optional)_
+- #### `io.buildpacks` _(table, optional)_
   A list of specifications for build-time configuration of the project.
 
-   - **`env`** _(list, optional)_
+   - **`build.env`** _(list, optional)_
     You can set environment variables at build time, by defining each with the following fields:
 
       - **`name`** _(string, optional)_\
@@ -64,7 +64,7 @@ The schema for the `project descriptor` is:
 
     > If `include` and `exclude` are both present, the lifecycle will error out.
 
-   - **`buildpacks`** _(list, optional)_
+   - **`group`** _(list, optional)_
     A list of buildpacks. Either a `version`, `uri`, or `script` table must be included, but it must not include any combination of these elements.
 
       - **`id`** _(string, optional)_\
@@ -94,34 +94,34 @@ The schema for the `project descriptor` is:
 ## Example
 An example `project.toml` is:
 ```toml
-[project]
+[_]
 id = "io.buildpacks.my-app"
 version = "0.1"
 
-[build]
+[io.buildpacks]
 include = [
     "cmd/",
     "go.mod",
     "go.sum",
     "*.go"
 ]
 
-[[build.env]]
+[[io.buildpacks.build.env]]
 name = "JAVA_OPTS"
 value = "-Xmx1g"
 
-[[build.buildpacks]]
+[[io.buildpacks.group]]
 id = "io.buildpacks/java"
 version = "1.0"
 
-[[build.buildpacks]]
+[[io.buildpacks.group]]
 id = "io.buildpacks/nodejs"
 version = "1.0"
 
-[metadata]
+[_.metadata]
 foo = "bar"
 
-[metadata.fizz]
+[_.metadata.fizz]
 buzz = ["a", "b", "c"]
 ```