better documentation draft