add yard documentation config
cleanup doc markup [ci skip]
Merge pull request #291 from wvengen/feature-yardoc

setup yard documentation
make Redis a softer dependency

(closes foodcoops#288)