improved docs about flash messages