improve default override, update readme and move to rst