pivotal-cf / docs-build-service

Documentation to help with installing and using Build Service
Apache License 2.0
6 stars 28 forks source link

More information on k14s tools and reference to it's new name "Carvel" #184

Open jgalvin98 opened 3 years ago

jgalvin98 commented 3 years ago

On the Installing TBS page, it would be helpful to provide a high level description of the install workflow. Included could be a section discussing why we "relocate" images. This is a differentiator and benefit of TBS vs. kpack providing airgapping and should be called out. If you are a first time user, the initial install steps jump right in and you have no idea why you are performing the steps. More info in this section on our use of K14s would also add clarity for users not familiar with the toolset. Additionally, having a "one-liner" next to/under each of the k14s CLI's would provide more clarity.

cf-gitbot commented 3 years ago

We have created an issue in Pivotal Tracker to manage this. Unfortunately, the Pivotal Tracker project is private so you may be unable to view the contents of the story.

The labels on this github issue will be updated when the story is started.

sukhil-suresh commented 3 years ago

Some of the issues you have raised have been addressed in the latest docs update

There is still more work outstanding in the Installation docs. Thank you for raising this issue @jgalvin98!