[TOMEE-2340] Make all h1, h2, h3 levels consistent

• Type: Documentation
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 8.0.0-M2
• Assignee: David Blevins
• Reporter: David Blevins
• Created: 09/Dec/18 02:24
• Updated: 09/Dec/18 03:10
• Resolved: 09/Dec/18 03:10

Description

Several of the documents jump around in h1, h2, h3, etc usages.

Some documents start at "==" and work down from there.  Some start at "==" and for no real reason jump down to "====".

 

It's assumed this is because it looks better to the individual document writer at the time when rendered against the given website CSS at the time.

 

Authors change.  CSS changes.  We need to be consistent.

 

I wrote a little code to ensure all h1, h2, etc levels start at 1 and proceed downward from there consistently.

https://github.com/apache/tomee-site-generator/blob/e1f56acdd154d2a28eedfb996b67bfad646fd14b/src/main/java/org/apache/tomee/website/AsciidocAdjustHeadingLevels.java