doc: fix all references to dim man page

Replace all links to the dim man page with :ref:`dim`, fixing a number
of broken links while at it. The :doc:`/dim` method would still work,
but unify on :ref:.

Fix contributing link to point at the right document instead of the man
page.

Signed-off-by: Jani Nikula <jani.nikula@intel.com>