In the YAML docs gen the cmd.Long maps to the description and cmd. Short maps to the synopsis.
In the other outputs, it's the reverse. For example, the MD docs gen, the cmd.Short maps to the command description and the cmd.Long maps to the command synopsis.
I think the MD version is correct and short/long fields should be swapped in the YAML generator.
In the YAML docs gen the
cmd.Longmaps to the description andcmd. Shortmaps to the synopsis.In the other outputs, it's the reverse. For example, the MD docs gen, the
cmd.Shortmaps to the command description and thecmd.Longmaps to the command synopsis.I think the MD version is correct and short/long fields should be swapped in the YAML generator.