updating markdown document (workshop notes in their entirety)