Restructure .yml docs

Signed-off-by: Aanand Prasad <aanand.prasad@gmail.com>
Improve some of the .yml options docs

Signed-off-by: Aanand Prasad <aanand.prasad@gmail.com>
Merge pull request #316 from orchardup/restructure-yaml-docs

Improve fig.yml docs