Add YAML-docs generation

[thaJeztah]

This is a very quick 'n dirty implementation of the YAML docs generation;
copied from the docker/cli repository with some minor modifications and a
new Makefile target.

I'll open a PR in the documentation repository to verify if the output all works (similar to docker/docs#8759); we should also

• have a look at making the generating code generic enough so that we can just vendor it (instead of copying)
• have a way to automate the yaml files in the documentation repository (perhaps be by pushing the docker image to hub)?

Example of the generated YAML files;

yamldocs.zip

[thaJeztah]

/cc @bermudezmt

[thaJeztah]

ping @chris-crone @silvin-lubecki PTAL; this is green now

[silvin-lubecki]

Hmm what is this docs/reference/.keep file? 🤔

[silvin-lubecki]

LGTM, thank you @thaJeztah for handling that 😍
Indeed we need some factorization with docker/cli on this code, but this can be done in a followup 👍

[thaJeztah]

Hmm what is this docs/reference/.keep file? 🤔

Right, so Git only stores files, not directories; the generator expects a directory containing Markdown files for the extended descriptions, which we currently don't have; we can remove that .keep file once there's some Markdown files in the directory

[bermudezmt]

@usha-mandya as we've discussed previously, the extended descriptions and examples (when we have them) should live in the reference folder. @silvin-lubecki this is an example Markdown addition from @thaJeztah : https://github.com/docker/registry-cli/pull/47/files 👋

[codecov]

Codecov Report

Merging #533 into master will decrease coverage by 0.41%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master     #533      +/-   ##
==========================================
- Coverage   71.44%   71.02%   -0.42%     
==========================================
  Files          59       59              
  Lines        3029     2989      -40     
==========================================
- Hits         2164     2123      -41     
+ Misses        583      582       -1     
- Partials      282      284       +2

Impacted Files	Coverage Δ
types/parameters/parameters.go	92.06% <0%> (-4.77%)	⬇️
internal/commands/image/list.go	83.33% <0%> (-4.17%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 433639b...f49d335. Read the comment docs.

[chris-crone]

LGTM, thanks @thaJeztah !