My edits to the second half of the basic docs

cc @stubailo @avital @Slava