clarify input documentation