@gemlog They are really good for things below certain level of complexity beyond which they become a mess. They are perfect when you read them, way less so when you write them.
Complex Docker container descriptions is where they truly "shine". I wouldn't even touch those without editor that highlights wrong indentation in bright red.
@amiloradovsky