update userguide for recent changes