fix url escaping; added beta/upgrade docs