engine: update reference docs to use new anchor tags

[thaJeztah]

• relates to / in preparation of engine: update docs for 23.0.0 #16416
• relates to cmd: set double quotes as code delimiter cli#3924
• relates to / depends on [20.10 backport] docs: add anchor tags for command-line flags cli#3525

This updates the engine reference documentation with the changes from docker/cli#3525. We're using the new anchor tags for the upcoming 23.0 release, and this PR prepares changes related to that, so that updating the docs for v23.0.0 will be easier (all things already updated)..

Once these changes are in, we can also fix the buildx docs to point to the new anchor tags, and remove the htmlproofer exclusion.

[netlify]

✅ Deploy Preview for docsdocker ready!

Name	Link
🔨 Latest commit	a7b9985
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/63bbdead5bc9c100082bdd8b
😎 Deploy Preview	https://deploy-preview-16460--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.

[thaJeztah]

the "fix anchor links" commit still needs to be squashed before merging as well

[thaJeztah]

• This is temporary for this PR, and will be removed before merging (after [20.10 backport] docs: add anchor tags for command-line flags cli#3525 is merged)

[thaJeztah]

I did a quick test with only the second commit of this PR to check if htmlproofer would fail, but looks good, so docker/cli#3525 is probably good to go

[thaJeztah]

This one should be ready for review now

@crazy-max@rumpl@dvdksn PTAL

[crazy-max]

Just an observation: I was looking at the Options table in https://deploy-preview-16460--docsdocker.netlify.app/engine/reference/commandline/build/ and I don't see any generated link on the name like --ulimit that should go to https://deploy-preview-16460--docsdocker.netlify.app/engine/reference/commandline/build/#-set-ulimits-in-container---ulimit.

[thaJeztah]

@crazy-max you mean the TOC (right-hand side)? I guess this is because Jekyll doesn't understand the <a name=...> tags, or perhaps we need to update it to take the quotes into account? (If we did those ourselves) 🤔 let me check

[thaJeztah]

@crazy-max It's probably this one that needs updating;

docs/_includes/toc_pure_liquid.html

Lines 1 to 17 in 1f4f22c

	{% capture tocWorkspace %}
	{% comment %}
	"...like all things liquid - where there's a will, and ~36 hours to spare, there's usually a/some way" ~jaybe
	Usage:
	{% include toc_pure_liquid.html html=content sanitize=true class="inline_toc" id="my_toc" toc_min=2 toc_max=3 %}
	Variables:
	* html (string) - the HTML of compiled markdown generated by kramdown in Jekyll
	* sanitize (bool) - when set to true, the headers will be sanitized in the TOC
	* class (string) - a CSS class assigned to the TOC
	* id (string) - an ID to assigned to the TOC
	* toc_min (int) - the minimum TOC header level to use (if not set, check page, then site, then default to 2)
	* toc_max (int) - the maximum TOC header level to use (if not set, check page, then site, then default to 3)
	Output:
	An unordered list representing the table of contents of a markdown block. This snippet will only generate the table of contents and will NOT output the markdown given to it
	{% endcomment %}

[crazy-max]

@crazy-max you mean the TOC (right-hand side)? I guess this is because Jekyll doesn't understand the <a name=...> tags, or perhaps we need to update it to take the quotes into account? (If we did those ourselves) 🤔 let me check

Not the TOC, the Options table where --ulimit should be a link like https://github.com/docker/buildx/blob/master/docs/reference/buildx_build.md#options? Maybe this is not needed with the sidebar TOC actually.

[thaJeztah]

Let me bring this one in 👍