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

Apparently the answer was obvious: http://sphinx-doc.org/rest.html#sections

# with overline, for parts
* with overline, for chapters
=, for sections
-, for subsections
^, for subsubsections
", for paragraphs

I had been using ==== as my top-level heading because that's what riv.vim does, but #### and **** are above them. ~~~~~ apparently isn't even official.

I still don't fully understand the problem, since I was using ---- above the locations that nominally were using ^^^^, which should be fine, but bumping all the headings up one level has solved my particular problem.