tweaked ratio, add ref doc