add a bit of content to shannon docs