add some links to intro paragraph
remove noise
tweak syntax