bring over more examples and code snippets from the allapc work, and update the portentious version with all the news docs