improve docs, add yardopts