update docs based on JamesM's tutorials