build: multi-stage builds user guide

[crazy-max]

carry a commit from #14905 to move "multi stage build" page to Build section > User guides. Let me know if User guides is right to you.

Signed-off-by: CrazyMax [email protected]

[netlify[bot]]

✅ Deploy Preview for docsdocker ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	d775c8a6bf6cdbdeea6d35be05b8593e771b1cb1
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/63230f4f7ee9ac0008fda2bf
😎 Deploy Preview	https://deploy-preview-15392--docsdocker.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[jedevc]

Hm having a section called "guides" in the "manuals" feels confusing.

Since this relates to Dockerfiles, I wonder if we should have a Dockerfile section under Docker Build? This would be a good first page to put there, but I can easily imagine lots of other content ending up there, like our best practices. Not quite sure, what do you think?

[crazy-max]

Since this relates to Dockerfiles, I wonder if we should have a Dockerfile section under Docker Build?

That SGTM but what about our guides in https://github.com/docker/buildx/tree/master/docs/guides? I recall you had some ideas for a folder under Docker Build section for them.

[jedevc]

but what about our guides in https://github.com/docker/buildx/tree/master/docs/guides? I recall you had some ideas for a folder under Docker Build section for them

Good point :laughing: I think they probably belong in the Buildx section directly, or maybe in an Advanced section under that, if we really start to get too many. I'm not quite sure, I think some of those guides, probably need some love and care before we put them on the site, especially some of the older ones, just to bring them into line with the style of the ones we've already got there.

[crazy-max]

@jedevc Moved to "Building images" section and rebased. PTAL.