buildpacks / docs

Web content for Cloud Native Buildpacks
https://buildpacks.io
Apache License 2.0
30 stars 162 forks source link

Add builder in common folder #700

Open starlightknown opened 5 months ago

starlightknown commented 5 months ago

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?

Additional Information

natalieparellano commented 5 months ago

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:

Whereas the app developers page should should answer (or contain links to) questions such as:

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 :)

starlightknown commented 4 months ago

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