Fix link and punctuation

[DJScias]

The arguments for the link syntax were switched and thus produced a broken link.

The rest is just nitpicks, can be ignored if necessary.

[hrydgard]

thanks!

might not see the results immediately, but I'll deploy the site again fairly soon. (have not set up auto deploy on merge)