First round of updates from feedback on intial docs.