detailed readme + shortcut updates