update README & deps; fixes #1
initial draft of part 1