updated docs to clarify rules around parameter naming for user data