feat(docs): generate docs

.github/dependabot.yml

@@ -1,5 +1,13 @@
 version: 2
 updates:
+  - package-ecosystem: "gomod"
+    directory: "/scripts/generate-buildpack-docs"
+    schedule:
+      interval: "weekly"
+    groups:
+      go:
+        patterns:
+          - "*"
   - package-ecosystem: "docker"
     directory: "/runimage"
     schedule:

.github/workflows/docs.yml

@@ -0,0 +1,60 @@
+name: Update Documentation
+
+on:
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  update-docs:
+    runs-on: ubuntu-latest
+    env:
+      TOOL_PATH: runway-buildpack-stack/scripts/generate-buildpack-docs
+      DOC_PATH: www/content/docs/platform/buildpacks/included-buildpacks
+    steps:
+    - id: generate-token
+      uses: actions/create-github-app-token@v2
+      with:
+        app-id: ${{ secrets.RUNWAY_CI_BOT_APP_ID }}
+        private-key: ${{ secrets.RUNWAY_CI_BOT_PRIVATE_KEY }}
+        owner: ${{ github.repository_owner }}
+        repositories: |
+          runway-buildpack-stack
+          ${{ secrets.WWW_REPO }}
+    - id: get-user-id
+      run: echo "user-id=$(gh api "/users/${{ steps.generate-token.outputs.app-slug }}[bot]" --jq .id)" >> "$GITHUB_OUTPUT"
+      env:
+        GH_TOKEN: ${{ steps.generate-token.outputs.token }}
+
+    - uses: actions/checkout@v6
+      with:
+        path: runway-buildpack-stack
+
+    - uses: actions/setup-go@v5
+      with:
+        go-version-file: ${{ env.TOOL_PATH }}/go.mod
+
+    - name: Generate buildpack documentation
+      working-directory: ${{ env.TOOL_PATH }}
+      run: |
+        go run main.go
+
+    - uses: actions/checkout@v6
+      with:
+        repository: ${{ github.repository_owner }}/${{ secrets.WWW_REPO }}
+        token: ${{ steps.generate-token.outputs.token }}
+        path: www
+
+    - run: |
+        mkdir -p ${{ env.DOC_PATH }}
+        cp -r runway-buildpack-stack/bp-docs/* ${{ env.DOC_PATH }}
+
+    - uses: peter-evans/create-pull-request@v7
+      with:
+        token: ${{ steps.generate-token.outputs.token }}
+        path: www
+        commit-message: "chore(docs): update buildpacks"
+        title: "chore(docs): update buildpacks"
+        branch: update-buildpack-docs
+        delete-branch: true
+        committer: ${{ steps.generate-token.outputs.app-slug }}[bot] <${{ steps.get-user-id.outputs.user-id }}+${{ steps.generate-token.outputs.app-slug }}[bot]@users.noreply.github.com>
+        author: ${{ steps.generate-token.outputs.app-slug }}[bot] <${{ steps.get-user-id.outputs.user-id }}+${{ steps.generate-token.outputs.app-slug }}[bot]@users.noreply.github.com>

.github/workflows/release.yml

@@ -170,3 +170,8 @@ jobs:
     - uses: softprops/action-gh-release@v2
       with:
         token: ${{ steps.generate-token.outputs.token }}
+
+  docs:
+    needs: [release]
+    uses: ./.github/workflows/docs.yml
+    secrets: inherit

.gitignore

@@ -1 +1,2 @@
 meta/*/buildpack.cnb
+bp-docs/*

meta/dotnet-core/buildpack.toml

@@ -5,7 +5,7 @@ api = "0.8"
   homepage = "https://www.runway.horse/docs/recipes/deploy-dotnet/"
   id = "runway-buildpacks/dotnet-core"
   keywords = ["dotnet"]
-  name = "Paketo Buildpack for .NET Core"
+  name = "Buildpack for .NET Core"
   version = "3.1.33"
 
   [[buildpack.licenses]]

meta/go/buildpack.toml

@@ -5,7 +5,7 @@ api = "0.7"
   homepage = "https://www.runway.horse/docs/recipes/deploy-go/"
   id = "runway-buildpacks/go"
   keywords = ["go", "golang"]
-  name = "Runway version of the Paketo Buildpack for Go"
+  name = "Buildpack for Go"
   version = "4.13.36"
 
   [[buildpack.licenses]]

meta/java-native-image/buildpack.toml

@@ -5,7 +5,7 @@ api = "0.7"
   homepage = "https://www.runway.horse/docs/recipes/java/"
   id = "runway-buildpacks/java-native-image"
   keywords = ["java", "composite", "native-image"]
-  name = "Paketo Buildpack for Java Native Image"
+  name = "Buildpack for Java Native Image"
   version = "11.15.29"
 
   [[buildpack.licenses]]

meta/java/buildpack.toml

@@ -5,7 +5,7 @@ api = "0.7"
   homepage = "https://www.runway.horse/docs/recipes/java/"
   id = "runway-buildpacks/java"
   keywords = ["java", "composite"]
-  name = "Paketo Buildpack for Java"
+  name = "Buildpack for Java"
   version = "18.12.47"
 
   [[buildpack.licenses]]

meta/nodejs/buildpack.toml

@@ -3,7 +3,7 @@ api = "0.7"
 [buildpack]
   homepage = "https://www.runway.horse/docs/recipes/javascript/"
   id = "runway-buildpacks/nodejs"
-  name = "Paketo Buildpack for Node.js"
+  name = "Buildpack for Node.js"
   version = "9.3.24"
 
   [[buildpack.licenses]]

meta/php/buildpack.toml

@@ -3,7 +3,7 @@ api = "0.7"
 [buildpack]
   homepage = "https://github.com/paketo-buildpacks/php"
   id = "runway-buildpacks/php"
-  name = "Paketo Buildpack for PHP"
+  name = "Buildpack for PHP"
   version = "2.19.26"
 
   [[buildpack.licenses]]

meta/python/buildpack.toml

@@ -2,7 +2,7 @@ api = "0.8"
 
 [buildpack]
   id = "runway-buildpacks/python"
-  name = "Paketo Buildpack for Python"
+  name = "Buildpack for Python"
   version = "2.30.24"
 
   [[buildpack.licenses]]

meta/ruby/buildpack.toml

@@ -5,7 +5,7 @@ api = "0.7"
   homepage = "https://www.runway.horse/docs/recipes/deploy-ruby/"
   id = "runway-buildpacks/ruby"
   keywords = ["ruby"]
-  name = "Paketo Buildpack for Ruby"
+  name = "Buildpack for Ruby"
   version = "0.47.32"
 
   [[buildpack.licenses]]

meta/runway/buildpack.toml

@@ -2,7 +2,7 @@ api = "0.7"
 
 [buildpack]
   id = "runway-buildpacks/runway"
-  name = "Composite buildpack to include our own buildpacks"
+  name = "Buildpack for hugo/mdbook"
   version = "0.1.27"
 
 [[order]]

scripts/generate-buildpack-docs/go.mod

@@ -0,0 +1,13 @@
+module generate-buildpack-docs
+
+go 1.25.4
+
+require (
+	github.com/BurntSushi/toml v1.6.0
+	github.com/buildpacks/libcnb/v2 v2.1.0
+)
+
+require (
+	github.com/Masterminds/semver v1.5.0 // indirect
+	github.com/onsi/gomega v1.38.2 // indirect
+)

scripts/generate-buildpack-docs/go.sum

@@ -0,0 +1,28 @@
+github.com/BurntSushi/toml v1.6.0 h1:dRaEfpa2VI55EwlIW72hMRHdWouJeRF7TPYhI+AUQjk=
+github.com/BurntSushi/toml v1.6.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
+github.com/Masterminds/semver v1.5.0 h1:H65muMkzWKEuNDnfl9d70GUjFniHKHRbFPGBuZ3QEww=
+github.com/Masterminds/semver v1.5.0/go.mod h1:MB6lktGJrhw8PrUyiEoblNEGEQ+RzHPF078ddwwvV3Y=
+github.com/buildpacks/libcnb/v2 v2.1.0 h1:Leq/mkEclb4nuJ6lmwZXt1H1TfhPdSXwcbR0qlp3GL4=
+github.com/buildpacks/libcnb/v2 v2.1.0/go.mod h1:9VOD2kS9Knw8MuMtJOPVj/62eiUTk+Dp+lmrjM7v8Lc=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/onsi/gomega v1.38.2 h1:eZCjf2xjZAqe+LeWvKb5weQ+NcPwX84kqJ0cZNxok2A=
+github.com/onsi/gomega v1.38.2/go.mod h1:W2MJcYxRGV63b418Ai34Ud0hEdTVXq9NW9+Sx6uXf3k=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/sclevine/spec v1.4.0 h1:z/Q9idDcay5m5irkZ28M7PtQM4aOISzOpj4bUPkDee8=
+github.com/sclevine/spec v1.4.0/go.mod h1:LvpgJaFyvQzRvc1kaDs0bulYwzC70PbiYjC4QnFHkOM=
+github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/net v0.44.0 h1:evd8IRDyfNBMBTTY5XRF1vaZlD+EmWx6x8PkhR04H/I=
+golang.org/x/net v0.44.0/go.mod h1:ECOoLqd5U3Lhyeyo/QDCEVQ4sNgYsqvCZ722XogGieY=
+golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk=
+golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=