How can I build the manual in doc locally? I have tried this:

$ mach xml
$ asciidoctor -b docbook5 yada-manual.adoc -o yada-manual.xml
asciidoctor: WARNING: authentication.adoc: line 53: no callout found for <1>
asciidoctor: WARNING: authentication.adoc: line 59: no callout found for <2>
asciidoctor: WARNING: authentication.adoc: line 67: no callout found for <3>
asciidoctor: WARNING: authentication.adoc: line 73: no callout found for <4>
asciidoctor: WARNING: authentication.adoc: line 81: no callout found for <5>
asciidoctor: ERROR: colophon.adoc: line 9: colophon sections do not support nested sections
asciidoctor: ERROR: colophon.adoc: line 13: colophon sections do not support nested sections

can you try deleting the include of the colophon and retrying? Maybe it's a different version of asciidoctor

we tend to use asciidoctor-pdf these days

I just discovered asciidoctor-pdf (via ruby) now, thanks