buildpacks
Add builder in common folder
Summary
Currently, https://buildpacks.io/docs/for-app-developers/concepts/builder/ this builder in concepts for app developers is different from https://buildpacks.io/docs/for-platform-operators/concepts/builder/ builder in the platform operators section.
What questions should this documentation answer?
Who is the target audience for this documentation?
- [ ] App Developer
- [ ] Buildpack Author
- [ ] Operator
- [ ] Other:
Additional Information
Thank you for noticing this :) I think the content from both pages could be consolidated and improved. That said I think the platform operators page should be more detailed and should answer (or contain links to) questions such as:
- How do I find out what is contained within a builder?
- How do I customize a builder?
- How do I create my own builder?
Whereas the app developers page should should answer (or contain links to) questions such as:
- How do I choose a builder from the available providers?
- How do I set a builder as a default?
- How do I receive updates to a builder?
The app developers page could link to the platform operators page as a way of going deeper. But, maybe there is a better way to do it that we haven't thought of :)
This is helpful. Yep we can make it different for each persona so that they can understand the same concept with a different point of view