improved shell example comments