update ratio documentation