build: rework ci/gha docs

[dvdksn]

This PR brings a restructuring of GitHub actions documentation, and expands on the existing docs by:

• Rewriting the CI description (currently based on an old blog post)
• Updating the guide/tutorial for GitHub Actions
• Including examples of advanced use cases

[netlify]

✅ Deploy Preview for docsdocker ready!

Name	Link
🔨 Latest commit	f636cc2
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/6363db697c446e00085e25f6
😎 Deploy Preview	https://deploy-preview-15898--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.

[dvdksn]

@crazy-max do you know why the gha advanced example pages do not get any breadcrumbs??

[crazy-max]

@crazy-max do you know why the gha advanced example pages do not get any breadcrumbs??

Hum I don't know, maybe there is a limit to the number of items? Any idea @thaJeztah?

Edit: yes looks limited to 4 levels:

docs/_includes/breadcrumbs.html

Lines 100 to 103 in 5636c5d

	{%- if level1_title -%}<li><a {%- if level1_url %} href="{{ level1_url }}"{%- endif -%}>{{ level1_title }}</a></li>{%- endif -%}
	{%- if level2_title -%}<li><a {%- if level2_url %} href="{{ level2_url }}"{%- endif -%}>{{ level2_title }}</a></li>{%- endif -%}
	{%- if level3_title -%}<li><a {%- if level3_url %} href="{{ level3_url }}"{%- endif -%}>{{ level3_title }}</a></li>{%- endif -%}
	{%- if level4_title -%}<li><a {%- if level4_url %} href="{{ level4_url }}"{%- endif -%}>{{ level4_title }}</a></li>{%- endif -%}

Should be dynamic imo.

[crazy-max]

I have mixed feeling about the examples layout. On one hand there are too many pages and TOC order is not quite satisfying. I wonder if this could just be on a single examples.md or cookbook.md page? WDYT?

[dvdksn]

I have mixed feeling about the examples layout. On one hand there are too many pages and TOC order is not quite satisfying. I wonder if this could just be on a single examples.md or cookbook.md page? WDYT?

I agree and I've updated the structure now! ptal and let me know if there's anything else you'd like me to change :)

Also wouldn't hurt if you just glanced over the "template repo" that I created for the tutorial. Before my changes, we asked ppl to fork an existing repo that used nginx and static HTML. I created a slimmer version that is also a template repo: https://github.com/dvdksn/clockbox

[crazy-max]

Also wouldn't hurt if you just glanced over the "template repo" that I created for the tutorial. Before my changes, we asked ppl to fork an existing repo that used nginx and static HTML. I created a slimmer version that is also a template repo: https://github.com/dvdksn/clockbox

Yes your example looks good to me!

I agree and I've updated the structure now! ptal and let me know if there's anything else you'd like me to change :)

Some examples are more important than others. I think we should change the order and group some of them:

• Push to multi-registries
• Manage tags and labels
• Multi-platform images
• Cache
• Secrets
• Export image to Docker
• Test your image before pushing it
• Local registry
• Share built image between jobs
• Named contexts
• Builder configuration
  • Append additional nodes
  • Authentication for remote builders
  • BuildKit daemon configuration
  • Standalone mode
• Isolated builders
• Copy images between registries
• Update Docker Hub repository description

For Registry mirror we should cross link to https://deploy-preview-15898--docsdocker.netlify.app/build/buildkit/configure/#registry-mirror

[crazy-max]

LGTM 🎉