Update intro documentation / comments