add .yardopts
use kramdown as markdown processor + restructure Gemfile