explicitly document the big secret