update docs && add date ref param