some more final touches, adding demo-notes in markdown