updating YARD
minor README update
fixing merge with resources and DOs