ref: added 0.5 increase, and new docs