add notes about keepNames and update examples