refine readme; add bash shortcut; add notes