update docs in the spirit of the blog post