updated doc re schema and some notes re WL architecture