What does “Title level inconsistent” mean?

Question

I\'ve been getting warnings in my documentation builds of the variety \"Title level inconsistent\". As far as I can tell, I have a consistent structure that looks something lik

Answer 1

Check the entire document and ensure that you're consistently using the same character to represent each level of hierarchy.

For example, ensure your sections (=), subsections (-), and subsubsections (~) are consistently using the same underline character across the entire document, and that you aren't using different underline characters for the same heading level by accident.