hmm.. documentation notes that it's prefereable to use :ref: syntax instead of `ref`_, it also states: Labels that aren’t placed before a section title can still be referenced to, but you must give the link an explicit title, using this syntax: :ref:`Link title <label-name>`."
however neither former not later can reference sections in other documents, am i missing something or that's how it was planned?
actually i take that back, :ref:`tiltle <section>` does not work locally either unless there is an explicit label, rendering documentation statement relatively inacurate