Add documentation of Foreman integration

add .yardopts for yardoc to be generated correctly