The spec looks like a more readable man page (compare to mandoc).

Nowadays, a lot of CLI libraries actually generate the help from the code of the cli (like picocli in Java or argparse in python, etc.).