few changes, add reference links and comment first example