more documentation, split README install section
Add redcarpet for yaml generation from markdowns
YARD formatting and list of files