Ratio docs

Status: **Ready to merge**

Reviewers: **@kpeatt @jeffkamo @ry5n**