Converting from Markdown to Docbook for publishing has some challenges. One example is that markdown creates an empty chapter by default and needs special notation to get this in. David proposed the following patch to fix some of the issues: https://review.openstack.org/#/c/75483/ Which now gave a "No title" as default chapter - which was fixed for identity-api with this patch: https://review.openstack.org/75490 But now markdown is broken as Mathew pointed out: https://github.com/openstack/identity-api/blob/master/openstack-identity-api/v3/src/markdown/identity-api-v3.md With this patch reverted, you see how it looks like: http://docs-draft.openstack.org/90/76390/1/check/gate-identity-api-tox-doc-publish-checkbuild/6aa6f4e/publish-docs/api/openstack-identity-service/3/content/index.html Does anybody have a good solution to move forward here? Andreas -- Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126