reduced header levels by 1 across files for consistency
turned reference into markdown link