documenting token scheme in parameters