Add Documentation for YAML files

Add documentation for

1. The benchmark resource object
2. The execution benchmark object

mentioned in merge request !125 (merged)

Fixed with !125 (merged), see #207 (closed) for a follow-up.

closed