Tweak our docs headers for proper document outline.

I need to go through the whole docs again after the Hugo switch to make sure I haven't missed anything.

Apart from this, I'm not sure if we should use the header classes (.h5, .h4) or not.