updating the walkthrough plus the dock

closing #484
#540
#543
#541
#528
#307