Yep, you're correct. 1 and 2 should remain in the index page. Everything else should be its own page, making sure we link correctly to them wherever we say "See below". The last one (13. Examples) should be an index page inside the examples sub directory.
As mentioned in #157, the index page should be split up into separate pages to make it more manageable.
Presently, there are sections for:
I think (1) and (2) should stay for certain. They can be combined, and basically explains what Maestro is and what it's for.
(3) should be its own page. It's basically a reference for all of the available parameters in
maestro.yaml
.The others I haven't really read. @mpetazzoni, you'd probably know better.