added distance documentation draft