docs update (WIP) #8