In recent PR (https://github.com/jenkins-infra/jenkins.io/pull/1795) a contributor added :doctitle: to a page. This is a completely valid way to add title to a asciidoc page. But that is not how we do it on the majority of pages on jenkins.io. (We generally use title: in the yaml front-matter).
Even more confusing is that none of these is required.
With a bit of testing, I determined that the following three examples produce the same output:
Version "A" seems to have the better behavior in `make run` local testing (awestruct dynamic rebuild). C seems needed to make PDF generation of Jenkins Handbook work right.
So, we use A and then add C for handbook pages.
We mention A in https://github.com/jenkins-infra/jenkins.io/blob/master/CONTRIBUTING.adoc#adding-a-blog-post but not under documentation.
We should pick a standard way to do this and programmatically enforce it on all adoc pages.