better comments in example code