updated doc source and resultant user-guide