Update docs&examples for yos
#72

an63 wants to merge docs into master

We do not currently have an analysis of these two commits