start fleshing out function docs