{"id":20632026,"url":"https://github.com/pivotal/docs-book-tanzu-buildpacks","last_synced_at":"2026-02-03T23:32:35.631Z","repository":{"id":39492488,"uuid":"270711505","full_name":"pivotal/docs-book-tanzu-buildpacks","owner":"pivotal","description":"Tanzu Buildpacks documentation book","archived":false,"fork":false,"pushed_at":"2024-09-11T11:36:00.000Z","size":122,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-04-15T18:58:42.632Z","etag":null,"topics":["buildpacks","documentation","tanzu","tanzu-build-service","tanzu-network"],"latest_commit_sha":null,"homepage":"https://docs.pivotal.io/tanzu-buildpacks/index.html","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pivotal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-06-08T15:02:36.000Z","updated_at":"2022-05-06T18:06:03.000Z","dependencies_parsed_at":"2025-04-15T19:06:37.723Z","dependency_job_id":null,"html_url":"https://github.com/pivotal/docs-book-tanzu-buildpacks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pivotal/docs-book-tanzu-buildpacks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal%2Fdocs-book-tanzu-buildpacks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal%2Fdocs-book-tanzu-buildpacks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal%2Fdocs-book-tanzu-buildpacks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal%2Fdocs-book-tanzu-buildpacks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pivotal","download_url":"https://codeload.github.com/pivotal/docs-book-tanzu-buildpacks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal%2Fdocs-book-tanzu-buildpacks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29061562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T23:14:54.203Z","status":"ssl_error","status_checked_at":"2026-02-03T23:14:50.873Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["buildpacks","documentation","tanzu","tanzu-build-service","tanzu-network"],"created_at":"2024-11-16T14:14:41.902Z","updated_at":"2026-02-03T23:32:35.611Z","avatar_url":"https://github.com/pivotal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  Tanzu Buildpacks Documentation Book\n\nThe content repo associated with this book is [pivotal/docs-tanzu-buildpacks](https://github.com/pivotal/docs-tanzu-buildpacks).\nFor specific information about Tanzu Buildpacks documentation,\nsee [Tanzu Buildpacks Docs](https://github.com/pivotal/docs-tanzu-buildpacks/blob/master/README.md).\n\n\nIn this topic:\n\n* [What's in this Repo](#whats-in-this-repo)\n* [Running locally](#running-locally)\n* [The Docs Toolchain](#the-docs-toolchain)\n* [Contributing to the Documentation](#contributing-to-the-documentation)\n* [Submitting a Pull Request](#submitting-a-pull-request)\n* [Determine Content Repos and Branches of a Book](#determine-content-repos-and-branches-of-a-book)\n* [Product Variables](#product-variables)\n\nThis book uses a centralized layout repository, [docs-layout-repo](https://github.com/pivotal-cf/docs-layout-repo).  \nYou must clone this repository to run `bookbinder bind local`.\n\nThe centralized layout repository is specified as the value of the `layout_repo` key in the `config.yml` file.\nBookbinder uses this centralized layout repository by default,\nbut files in the book's `master_middleman/source` directory override files\nin the centralized layout repository if they have the same name.\n\n## What's in this Repo\n\nHere you'll find the configuration and templates for the Tanzu Buildpacks documentation.\n\n[//]: # \"set published eventually to [docs.pivotal.io/tanzu-buildpacks/](http://docs.pivotal.io/tanzu-buildpacks/).\"\n[//]: # \"staging site published to [docs-pcf-staging.cfapps.io/tanzu-buildpacks/](http://Cdocs-pcf-staging.cfapps.io/tanzu-buildpacks).\"\n\nThis repository *does not* contain the actual documentation content.\nActual content is contained in the topic repositories listed in the `config.yml` file.\n\nThe `master_middleman` folder contains the templates used for publishing.\n\n## Running Locally\nClone the following repositories:\n* [docs-layout-repo](https://github.com/pivotal-cf/docs-layout-repo)\n* [docs-tanzu-buildpacks](https://github.com/pivotal/docs-tanzu-buildpacks)\n\nFrom the home directory of the docs-book-tanzu-buildpacks repository, run:\n```\nbundle install\nbundle exec bookbinder bind local\ncd final_app/\nbundle install\nbundle exec rackup\n```\nIn a browser, open: http://localhost:9292/tanzu-buildpacks\n\nAlternatively, you can see a live preview of the docs by running:\n```\nbundle install\nbundle exec bookbinder watch\n```\nIn a browser, open: http://localhost:4567/tanzu-buildpacks.\n\nIf you you don't see the bound book at the above URL,\nmake sure you have the required bookbinder dependencies outlined\nin the [Bookbinder/Bookbindery](https://github.com/pivotal-cf/bookbinder/blob/master/README.md) readme.\n\n## The Docs Toolchain\n\nThe Tanzu documentation is written in markdown and published using the [Bookbinder gem](http://github.com/pivotal-cf/bookbinder) to generate the documentation as a web application with [Middleman](http://middlemanapp.com/).\n\n\n## Contributing to the Documentation\n\nThe docs team prefers to receive documentation contributions as pull requests rather than\nhaving engineering teams push directly to the docs repos.\nThis gives us a chance to review the changes for consistency and understand the new content.\n\nIf you are planning to initiate a large documentation effort,\nplease coordinate with the docs team in advance to make sure we're not going to step on each other.\nYou can reach the docs team by email at [cf-docs@pivotal.io](mailto:cf-docs@pivotal.io).\n\nIf you are trying to figure out where a particular bit of information should live, please reach out and ask.\nWe're happy to help you ensure information goes to the right place.\n\n## Submitting a Pull Request\n\nThis is a Bookbinder project. See [its README](https://github.com/pivotal-cf/bookbinder/blob/master/README.md) for instructions on how edits are made.\n\n\n## Determine Content Repos and Branches of a Book\n\nThe `config.yml` defines the content repos for each book.\nThe `config.yml` file of each book contains the list of content repos and branches that appear in the doc set.\nIn the `config.yml` file, each content repo is specified in the `repository` subsection.\nThis subsection includes an optional `ref` key-value pair which defines the branch of the content repo the book uses.\n\nMake sure that you are adding your content to the correct branches of the content repos.\n\nTo determine which branch of a content repo a book version uses:\n\n1. Confirm that you are on the correct book branch. For example, the currently published doc might be on the `master` branch\nor on the branch corresponding to its version number.\n\n2. Open the `config.yml` file.\n\n3. Search for the name of the content repo, for example, `docs-cloudfoundry-concepts`.\n\n4. Review the `repository` subsection for the content repo.\n   If there is no `ref:` tag, then the repo uses the master branch.\n   If there is a `ref` key-value pair, it specifies the branch name of the content repo.\n\n## Product Variables\n\nVariables for this book are in `config/template_variable.yml`.\nDon't make more variables than absolutely necessary.\nMinimizing variable usage in this book will make it easier for the engineering team to contribute.\n\nIf you need to make more variables, be consistent with variables in other books,\nsee [Product Variables](https://docs-wiki.cfapps.io/wiki/style/product-variables.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivotal%2Fdocs-book-tanzu-buildpacks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpivotal%2Fdocs-book-tanzu-buildpacks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivotal%2Fdocs-book-tanzu-buildpacks/lists"}