HIG - tighten up the dialogs page

Restructure to make the advice on buttons clearer. Includes
some advice from https://bugzilla.gnome.org/show_bug.cgi?id=338029