Ratio docs

Status: **Ready to merge**

Reviewers: **@kpeatt @jeffkamo @ry5n**
This markup is really hard to read. I think we could just show a few examples with the different types of elements we accept. If we accept em all we should just say so.